《Java 编 程 思想 》 的 作者 Bruce Eckel 认 为 ，Kotlin 或 将 取代 Java 
阿里 巴巴 资深 程序 员 哎 心 沥 血 之 作 ， 揭 秘 Kotlin 编 程 的 精华 
全 面 涵盖 Kotlin 基 础 语法 、 进 阶 实战 技巧 和 项 目 案例 开发 等 实用 内 容 
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内 容 简介 
本 书 从 Kotlin 语言 的 基础 语法 讲 起 ， 逐 步 深入 到 Kotlin 进 阶 实 战 ， 并 在 最 后 配合 项 目 实战 案例 ， 重 


点 介绍 了 使 用 KotlintSpring Boot 进行 服务 端 开发 和 使 用 Kotlin 进行 Android 应 用 程序 开发 的 内 容 ， 让 读 
者 不 但 可 以 系统 地 学 习 Kotlin 编程 的 相关 知识 ， 而 且 还 能 对 Kotlin 应 用 开发 有 更 为 深入 的 理解 。 


本 书 分 为 14 章 ， 涵 盖 的 主要 内 容 有 Kotlin 简介 ，Kotlin 语法 基础 ， 类 型 系统 与 可 空 类 型 ， 类 与 面向 


对 象 编程 ， 函 数 与 函数 式 编程 ， 扩 展 函数 与 属性 ， 集 合 类 ， 泛 型 ， 文 件 IO 操作 、 正 则 表达 式 与 多 线程 ， 
使 用 Kotlin 创建 DSL， 运 算 符 重 载 与 约定 ， 元 编程 、 注 解 与 反射 ，Kotlin 集成 Spring Boot 服务 端 开发 ， 
使 用 Kotlin 进行 Android 开发 。 
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本 书 内 容 通 俗 易 懂 ， 案 例 丰 富 ， 实 用 性 强 ， 特 别 适合 Kotlin 语言 的 入 门 读者 和 进 阶 读者 阅读 ， 也 适 


合 Android 程序 员 、Java 程序 员 等 其 他 编程 爱好 者 阅读 ， 还 适合 作为 相关 培训 机 构 的 教材 。 


本 书 封面 贴 有 清华 大 学 出 版 社 防伪 标签 ， 无 标签 者 不 得 销售 。 
版 权 所 有 ， 侵 权 必 究 。 侵 权 举报 电话 : 010-62782989 13701121933 


图 书 在 版 编目 (CIP) 数据 


Kotlin 从 入 门 到 进 阶 实 战 / 陈 光 剑 编著 . 一 北京 : 清华 大 学 出 版 社 ，2018 
ISBN 978-7-302-50872-4 


1. OK Il. OM IL DJAVA 语言 -程序 设计 IV. OTP312.8 


中 国 版 本 图 书馆 CIP 数据 核 字 (2018) 第 181509 号 


责任 编辑 : 杨 如 林 
封面 设计 : 欧 振 旭 
责任 校对 : 徐 俊 伟 
责任 印 制 ， 李 红 英 


出 版 发 行 : 清华 大 学 出 版 社 


网 it: http://www.tup.com.cn, http:/Avww.wqbook.com 

地 ks 北京 清华 大 学 学 研 大 厦 A 座 AB ” 编 : 100084 

社 总 机 : 010-62770175 邮 购 : 010-62786544 
投稿 与 读者 服务 : 010-62776969, c-service@tup.tsinghua.edu.cn 

KR 量 E 馈 : 010-62772015, zhiliang@tup.tsinghua.edu.cn 


装 者 : 三 河 市 金 元 印 装 有 限 公司 
销 : 全 国 新 华 书店 
Æ: 185mm 260mm ED 张 : 17 字 ” 数 : 428 千 字 
次 : 2018 年 9 月 第 1 版 印 ”次 : 2018 年 9 月 第 1 次 印刷 
价 : 69.80 元 


: 品 编号 : 080566-01 


了 中 


前 


当下 ， 互 联网 、 大 数据 和 云 计算 迅 狐 发展， 数 以 百 万 计 的 应 用 程序 在 服务 器 和 移动 端 
运行 。 这 些 应 用 程序 的 开发 语言 有 很 大 一 部 分 是 用 软件 界 已 经 流行 了 20 年 之 久 的 主力 编程 
语言 Java 编写 的 。 

“CEM, Java 语言 历史 悠久 ， 影 响 力 巨大 。 历 经 20 多 年 的 发 展 ， 它 已 经 成 为 一 门 
非常 成 熟 的 编程 语言 ， 性 能 强大 而 稳定 。Java 虚拟 机 JVM 的 生态 也 繁荣 昌盛 ， 经 久 不 衰 。 
但 Java 也 背负 着 历史 的 包 补 ， 如 它 有 空 指针 、 语 法 哆 嗪 和 不 支持 一 等 函数 等 缺点 。 如 果 用 
- 辆 汽车 来 比喻 编程 语言 ，Java 拥有 一 个 高 效 而 可 靠 的 发 动机 ， 但 其 防 抱 死 刹 车 系统 和 动 
力 转向 系统 却 不 是 那么 可 控 。Java 语言 在 使 用 时 需要 小 心 检 查 可 能 出 现 的 空 指针 ， 还 要 处 
理 异 常 、 重 复生 成 元 长 而 单调 的 样板 代码 行 等 问题 。 

对 于 开发 人 员 而 言 ， 编 程 语言 的 防 危 性 〈safety) 和 安全 性 〈security) 是 至 关 重 要 的 。 


和 可 控 ， 那 真是 再 好 不 过 了 。 我 们 很 高 兴 地 看 到 ，Kotlin 就 是 一 门 这 样 的 语言 。 

目前 ， 图 书市 场 上 Kotlin 相关 图 书 还 很 少 ， 尤 其 是 实用 性 强 的 书 更 是 凤毛麟角 。 为 了 
帮助 广大 的 编程 人 员 系 统 地 学 习 这 门 开发 语言 ， 笔 者 编写 了 本 书 。 本 书 从 Kotlin 语言 的 基 
础 语法 讲 起 ,逐步 介绍 了 Kotlin 的 扩展 函数 、 一 等 函数 支持 、Lambda 表达 式 、 强 大 的 DSL 
支持 、 运 算 符 重 载 与 约定 、 无 编程 、 注 解 与 反射 等 特性 ， 并 配合 项 目 实战 案例 ， 详 细 介 绍 
了 使 用 Kotlin+Spring Boot 进行 服务 端 开发 和 使 用 Kotlin 进行 Android 应 用 程序 开发 的 内 
容 。 通 过 阅读 本 书 ， 读 者 不 但 可 以 系统 地 学 习 Kotlin 编程 的 相关 知识 ， 而 且 还 能 对 Kotlin 
应 用 开发 有 更 为 深入 的 理解 。 


本 书 特色 


1. 内 容 全 面 ， 讲 解 由 浅 入 深 ， 符 合 学 习 规 律 

本 书 内 容 涵盖 了 Kotlin 语言 的 基础 语法 和 大 部 分 最 常用 的 核心 知识 点 和 开发 技巧 ， 还 
详细 介绍 了 两 个 实用 性 很 强 的 项 目 开发 案例 。 讲 解 遵循 由 浅 入 深 、 循 序 渐进 的 原则 ， 让 读 
者 的 学 习 曲 线 更 加 平滑 。 这 样 的 内 容 梯度 安排 和 讲解 ， 符 合 读者 的 编程 语言 学 习 规律 ， 可 
以 取得 较 好 的 学 习 效果 。 

2. 图 文 并 茂 ， 讲 解 生动 有 趣 ， 阅 读 起 来 不 枯燥 


技术 学 习 ， 有 时 一 图 胜 千言 。 本 书 在 介绍 知识 点 时 尽量 给 出 简单 易 懂 的 图 示 帮 助 读者 
里 解 ， 这 使 得 整个 学 习 过 程 变 得 简单 、 有 趣 。 


ei 
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3. 用 代码 示例 引导 学 习 ， 可 以 大 大 提高 动手 编程 能 力 

本 书 非 常 注重 内 容 的 实用 性 和 可 操作 性 ， 书 中 重点 介绍 的 知识 点 都 给 出 了 大 量 代码 示 
例 ， 并 且 对 代码 做 了 详细 的 注释 和 讲解 ， 这 样 可 以 大 大 提高 读者 实际 动手 编程 的 能 力 。 

4. 偏重 于 实战 讲解 ， 不 涉及 不 常用 的 知识 

相 比 笔者 的 另外 一 本 书 《Kotlin 极 简 教 程 》， 本 书 内 容 更 加 偏重 于 Kotlin 编程 实战 讲 
解 。 书 中 对 于 Kotlin 基础 知识 和 语言 特性 的 讲解 更 加 精简 ， 重 点 突出 ， 而 对 于 编程 实战 中 
不 常用 的 一 些 内 容 不 做 过 多 介绍 ， 比 如 没有 介绍 目前 不 常用 的 Kotlin Native 和 实验 阶段 的 
协 程 〈《Coroutine) 两 个 专题 ， 但 增加 了 在 编程 实践 中 较为 常用 的 元 编程 、 注 解 与 反射 ， 运 
算 符 重 载 与 约定 两 章 的 内 容 。 

5. 项 目 案例 实用 性 强 ， 可 以 提高 项 目 开发 水 平 


本 书 最 后 两 章 配 合 项 目 实战 案例 ， 详 细 介绍 了 使 用 Kotlin+Spring Boot 进行 服务 端 开 
发 和 使 用 Kotlin 开发 Android 应 用 程序 的 相关 内 容 。 这 两 个 项 目 案例 可 以 带领 读者 体验 实 
际 的 Kotlin 应 用 开发 ， 可 以 大 幅度 提高 读者 的 项 目 实战 开发 水 平 。 


本 书 内 容 


第 1 章 主要 介绍 了 Kotlin 编程 语言 的 基本 特性 、 编 程 哲学 、 学 习 工 具 ， 以 及 为 什么 要 
学 Kotlin 和 JVM 语言 生态 等 内 容 。 

第 2 章 主要 介绍 了 Kotlin 语法 基础 ， 主 要 内 容 包 括 变 量 和 标识 符 、 关 键 字 与 修饰 符 、 
流程 控制 语句 、 操 作 符 与 重 载 、 包 声明 等 内 容 。 

第 3 章 主要 介绍 了 Kotlin 的 类 型 系统 、 可 空 类 型 、 安 全 操作 符 、 特 殊 类 型 、 类 型 检测 
与 类 型 转换 等 内 容 。 

第 4 章 主要 介绍 了 Kotlin 的 类 与 面向 对 象 编程 ， 包 括 声明 类 、 抽 象 类 与 接口 、object 
对 象 、 数 据 类 、 注 解 、 枚 举 和 内 部 类 等 内 容 。 

第 5 章 主 要 介绍 了 Kotlin 函数 式 编程 ， 包 括 声明 函数 、Lambda 表达 式 、 高 阶 函数 及 
Kotlin 中 的 特殊 函数 等 内 容 。 

第 6 章 主要 介绍 了 Kotlin 扩展 函数 与 属性 ， 以 及 扩展 函数 的 实现 原理 和 扩展 中 的 this 
关键 字 。 
第 7 章 主要 介绍 了 Kotlin 集合 类 ， 包 括 常用 的 3 种 集合 类 、 不 可 变 集合 类 、 创 建 集合 
类 、 遍 历 集合 中 的 元 素 、 映 射 函 数 、 过 滤 函 数 、 排 序 函 数 和 元 素 去 重 等 内 容 。 
第 8 章 主要 介绍 了 Kotlin 的 泛 型 ,包括 为 何 引 入 泛 型 、 泛 型 接口 、 泛 型 类 、 泛 型 函数 、 
类 型 上 界 、 协 变 与 逆 变 、out T mt, Zem e. 

第 9 章 主要 介绍 了 Kotlin 语言 的 文件 IO 操作 、 网 络 IO 操作 、 执 行 Shell 命令 、 正 则 
表达 式 和 多 线程 编程 等 相关 内 容 。 

第 10 章 主要 介绍 了 怎样 使 用 Kotlin 语言 创建 DSL， 包 括 什么 是 DSL、Kotlin 的 DSL 
特性 支持 ， 同 时 实现 了 一 个 集合 类 的 流 式 Kotlin DSL 实例 及 一 个 SQL 风格 的 集合 类 DSL 
实例 。 
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第 11 章 主要 介绍 了 Kotlin 的 运算 符 重 载 与 约定 ， 包 括 什 么 是 运算 符 重 载 、 重 载 二 元 
算术 运算 符 、 重 载 自 增 自 减 一 元 运算 符 、 重 载 比 较 运算 符 及 重 载 计算 赋值 运算 符 等 内 容 。 

第 12 章 主要 介绍 了 Kotlin 元 编程 、 注 解 与 反射 的 相关 内 容 ， 包 括 元 编程 简介 、 声 明 
注解 、 使 用 注解 、 处 理 注解 、 反 射 、 类 引用 、 函 数 引 用 、 属 性 引用 、 绑 定 函数 、 使 用 反射 
获取 泛 型 信息 等 内 容 。 

第 13 章 介绍 Kotlin 集成 Spring Boot 服务 端 开 发 ， 首 先 用 Spring Boot 快速 开发 一 个 
Restful Hello World 示例 ， 然 后 给 出 了 一 个 完整 的 图 片 企 虫 Web 应 用 项 目 案例 。 

第 14 章 介绍 如 何 使 用 Kotlin 进行 Android FR, 首先 给 出 了 一 个 简单 的 Kotlin 版 本 的 
Hello World Android 示例 程序 ， 然 后 详细 介绍 了 用 Kotlin 开发 一 个 电影 指南 Android 应 用 
程序 综合 项 目 案例 。 


本 书 读者 对 象 


Kotlin 入 门人 员 ; 
Kotlin 进 阶 开发 人 员 ; 
Android 程序 员 ; 

Java 程序 员 ; 

其 他 编程 爱好 者 ; 
相关 培训 机 构 的 学 员 。 
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本 书 源 程序 获取 方式 


本 书 涉及 的 源 代码 需要 读者 自行 下 载 。 请 登录 清华 大 学 出 版 社 网 站 www.tup.com.cn， 
搜索 到 本 书页 面 ， 在 页 面 上 找到 “资源 下 载 ” 栏 目 ， 然 后 单 击 “ 课 件 下 载 ” 或 者 “网 络 资 
源 ” 按 钮 即 可 下 载 。 
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#18 Kotlin 是 什么 


Kotlin 是 一 种 非 研究 性 并 且 非 常务 实 的 工业 级 编程 语言 ， 它 的 使 命 就 是 帮助 程序 员 解 
决 实际 工程 实践 中 的 问题 。 使 用 Kotlin 语言 让 Java 程序 员 的 工作 变 得 更 轻松 ，Java 语言 
的 那些 空 指针 错误 、 浪 费时 间 的 元 长 的 样板 代码 、 哆 嗪 的 语法 限制 等 ， 在 Kotlin 语言 中 统 
统 消失 。Kotlin 语言 简单 、 务 实 ， 语 法 简洁 而 强大 ， 安 全 且 表 达 力 强 ， 极 富生 产 力 。 

本 章 首先 简单 介绍 Kotlin 语言 的 发 展 历史 和 语言 特性 ， 然 后 简 述 为 什么 要 学 习 Kotlin 
语言 ， 最 后 简要 介绍 JVM 语言 家 族 。 


1.1 初 识 Kotlin 


Kotlin 是 一 种 基于 JVM 的 静态 类 型 编程 语言 。Kotlin 从 开始 推出 至 今 已 经 有 7 年 ， 
2016 年 官方 正式 发 布 了 首 个 稳定 版 本 。Kotlin 发 展 简 史 如 下 : 

Q 2011 年 7 月 ，JetBrains 推出 Kotlin 项 目 。 

口 2012 年 2 月 ，JetBrains 以 Apache 2 许可 证 开源 此 项 目 。 

D 2016 年 2 月 15 H, Kotlin v1.0〈 第 1 个 官方 稳定 版 本 ) 发 布 。 

口 2017 Google IO 大 会 上 ，Kotlin“ 转 正 ”。 

Kotlin 具备 类 型 推断 、 多 范式 支持 、 可 空 性 表达 、 扩 展 函 数 、 模 式 匹 配 等 诸多 下 一 代 
编程 语言 特性 。 

Kotlin 的 编译 器 kompiler 可 以 被 独立 出 来 并 嵌入 到 Maven, Ant 或 Gradle 工具 链 中 。 
这 使 得 在 IDE 中 开发 的 代码 能 够 利用 己 有 的 机 制 来 构建 ， 可 以 在 新 环境 中 自由 使 用 。 

让 我 们 从 Hello World 开始 。 与 C、C++、Java 语言 一 样 ，Kotlin 程序 的 入 口 点 是 一 个 
名 为 main0 的 函数 ， 它 传递 一 个 包含 任何 命令 行 参数 的 数组 。 代 码 示例 如 下 : 


package com.easy.kotlin //(1) 
fun main(args: Array<String>) { //(2) 
val name = "World" 
println("Hello, $name!") // (3) 


` 


上 面 的 代码 简单 说 明 如 下 。 

(1) : Kotlin 中 包 package 的 使 用 与 Java 基本 相同 。 有 一 点 不 同 的 是 Kotlin 的 package 
命名 可 以 与 包 路 径 不 同 。 

(2) : Kotlin 变量 声明 args:Array 类 似 于 Pascal， 先 写 变 量 名 args. ESRF, YE 
后 面 写 变量 的 类 型 Array。 与 Scala 和 Groovy 一 样 ， 代 码 行 末尾 的 分 号 是 可 选 的 ， 在 大 多 
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数 情况 下 ， 编 译 器 根据 换行 符 就 能 够 推断 语句 已 经 结束 。Kotlin 中 使 用 fun 关键 字 声 明 函 
数 (方法) ， 充 满 乐趣 的 fun。 

(3):Kotlin 中 的 打印 函数 是 println0( 虽 然 背后 封装 的 仍然 是 Java 的 System.out printin() 
方法 ) 。Kotlin 中 支持 字符 串 模 板 Sname， 如 果 是 表达 式 ， 则 使 用 ${fexpression} 语 法 。 


12 语言 特性 


人 们 为 什么 喜欢 Kotlin? Kotlin 为 什么 值得 我 们 去 学 习 ? 下 面 是 一 个 不 完全 的 清单 

列表 。 

与 Java 及 JVM 的 完全 互 操作 性 ; 

多 平台 : 适合 Android、 浏 览 器 JavaScript) 和 本 地 系统 编程 (native) ; 
RAR EFAS) ; 

富 于 表现 力 和 高 效 的 生产 力 ; 

支持 类 型 推断 。 例 如 ， 我 们 可 以 只 写 val number=23， 编 译 器 会 推断 这 是 一 个 Int; 
可 以 使 用 数据 类 (data class) 以 极 简 的 方式 创建 POJO; 

运算 符 重 载 相当 简单 ; 

快速 、 方 便 地 扩展 内 置 类 、 自 定义 类 的 函数 与 属性 ; 

区 分 可 空 类 型 和 不 可 空 类 型 。 直 接 在 编译 期 语法 层面 检查 可 空 类 型 ， 提 供 空 安全 
保障 ; 

Kotlin 含有 功能 丰富 的 集合 类 Stream API; 

集成 扩展 了 简单 实用 的 文件 WO、 正 则 匹配 、 线 程 等 工具 类 ; 

提供 了 实用 强大 的 函数 式 编程 支持 : 一 等 函数 支持 , Lambda 表达 式 、 高 阶 函 数 等 ; 
能 够 轻松 、 方 便 地 创建 DSL; 

使 用 更 加 轻 量 级 的 协 程 进行 并 发 编程 ; 

IntelliJIDEA 开发 工具 的 一 等 支持 ; 

Android 开发 有 Android Studio 3 内 置 原生 支持 ; 

提供 的 Anko EE Chttps://github.com/Kotlin/anko) 使 得 Android 开发 速度 更 快 ， 充 
满 更 多 的 乐趣 等 。 

Kotlin 的 优势 是 既 有 Java 的 完整 生态 (Kotlin 完全 无 颖 使 用 各 类 Java API HERE) ， 
又 有 现代 语言 的 高 级 特性 〈 语 法 糖 ) 。 

Kotlin 语言 的 设计 初衷 之 一 是 为 了 JetBrains 团队 内 部 使 用 ， 旨 在 帮助 公司 降低 成 本 。 
用 过 IntelliJ IDEA 的 程序 员 都 知道 JetBrains 团队 的 出 品 皆 是 良品 。 毫 无 疑问 ，Kotlin 的 设 
计 是 务实 的 。 发 展 和 促进 Kotlin 的 好 处 大 于 其 成 本 ， 在 这 个 过 程 中 ，Kotlin 已 经 演变 成 了 
一 个 JetBrains 的 效率 工具 ,其 显著 的 务实 特性 吸引 了 一 大 批 Java 程 序 员 ,并 成 为 了 JetBrains 
工具 生态 系统 中 重要 的 一 员 。 

在 未 来 几 年 内 ，Kotlin 有 望 成 为 主要 的 非 Java 的 JVM 语言 ， 甚 至 有 一 天 成 为 下 一 个 
”语言 。 可 以 预测 的 是 ，Kotlin 将 大 大 提升 整个 Java 互联 网 开发 者 的 效率 和 质量 。 


oooooooodono 


Ooooooodoano 


“Java 


IER 


第 1 章 Kotlin 是 什么 


Kotlin 语言 的 特性 可 以 简单 概括 为 以 下 几 方 面 。 

1. XAEX (Pragmatic) 

务实 、 注 重工 程 实践 性 。 我 们 经 常会 听 到 人 们 说 编程 是 数学 ， 或 者 是 工程 ， 是 艺术 ， 
是 科学 ， 这 些 说 法 都 是 很 有 道理 的 。Kotlin 是 一 门 偏重 工程 实践 、 编 程 上 有 极 简 风 格 的 


Ta A o 


2. REX (Minimalist) 


Kotlin GEI, ierch DIER RO (reference) 。 
3. BRS (Null Safety) 


Kotlin 中 有 一 个 简单 完备 的 类 型 系统 来 支持 空 安全 。 

4. 多 范式 (multi-paradigm) 

Kotlin 同时 支持 OOP 与 FP 编程 范式 。 各 种 编程 风格 的 组 合 可 以 让 我 们 更 加 直接 地 表 
达 算 法 思想 和 解决 问题 的 方案 ， 可 以 赋予 我 们 在 思考 上 有 更 大 的 自由 度 和 灵活 性 。 

5. 可 扩展 

Kotlin 可 直接 扩展 类 的 函数 与 属性 (extension functions & properties) 。 这 与 我 们 在 Java 
中 经 常 写 的 util 类 是 完全 不 一 样 的 体验 ! Kotlin 是 一 种 非常 注重 用 户 体验 的 语言 。 

6. 高 阶 函 数 与 闭 包 (higher-order functions & closures) 

Kotlin 的 类 型 中 ， 函 数 类 型 (function type) 也 是 一 等 类 型 (first class type) 。 在 Kotlin 


中 可 以 把 函数 当成 值 进行 传递 ， 这 直接 赋予 了 Kotlin 函数 式 编程 的 特性 ， 使 用 Kotlin 可 以 
写 出 一 些 非常 “优雅 ”的 代码 。 


7. 支持 快速 实现 DSL 


有 了 扩展 函数 、 闭 包 等 特性 的 支持 ， 使 用 Kotlin 实现 一 个 DSL 将 会 相当 简单 、 方 便 。 
1.2.1 Kotlin 5 Java 完全 互 操作 


Kotlin 是 基于 JVM 平台 的 静态 编程 语言 ， 同 时 在 设计 之 初 就 把 与 Java 的 互 操作 性 当 
作 重 要 目标 。 正 如 官方 网 站 所 宣传 的 那样 : 100% interoperable with Java and Android。 下 面 
我 们 举 个 简单 例子 来 展示 Kotlin 中 使 用 Java 的 ArrayList 类 与 使 用 JUnit 测试 框架 进行 单元 
测试 。 代 码 示例 如 下 : 
fun getArrayList(): List<string> { // (A) 函数 声明 
val arrayList = ArrayList<String>() //(2)Kotlin 中 直接 调用 Java 的 API 


arrayList.add("A") 
arrayList.add("B") 
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arrayList.add("C") 
return arrayList 


i 


代码 说 明 如 下 。 

(1) : 声明 了 一 个 返回 List<String> 的 函数 ， 我 们 看 到 在 Kotlin 中 使 用 fun 关键 字 来 声 
明 函 数 。 

(2) : 创建 了 一 个 ArrayList<String> 对 象 ， 我 们 可 以 看 到 ， 在 Kotlin 中 创建 对 象 不 再 
使 用 new 关键 字 了 ， 尖 括号 里 面 的 String 是 泛 型 信息 。 该 语法 与 Java 语言 基本 类 似 。 关 于 
集合 类 与 泛 型 的 相关 内 容 ， 将 在 第 7 章 和 第 8 章 中 具体 介绍 。 

下 面 使 用 JUnit 框架 进行 单元 测试 。 代 码 如 下 : 

package com.easy.kotlin // (3) 包 声明 

import org.junit.Assert 

import org.junit.Test 


import org.junit.runner.RunWith 
import org.junit.runners.JUnit4 // (4) 导 入 JUnit 的 类 


@RunWith (JUnit4::class) // (5) 直接 使 用 Java EASE JUnit 中 的 注解 6RunWith 
class FullJavaInteroperabilityTest { 


@Test 1 (6) 标记 这 是 一 个 测试 方法 
fun test() { 
val list = getArrayList () // (7) 调用 被 测试 函数 
Assert.assertTrue (list.size == 3) // (8) 断言 
} 
} 
代码 说 明 如 下 。 


G): 是 包 声 明 ， 使 用 package 关键 字 。 

(4) : 使 用 import 导入 JUnit4 类 。 

(5) : Kotlin 中 使 用 @RunWith 注解 ， 方 式 与 Java 语法 类 似 。 注 解 中 的 参数 是 
JUnit4::class， 是 JUnit4 类 的 引用 。 我 们 将 在 第 12 章 中 介绍 注解 与 反射 。 

(6) : 使 用 JUnit 的 @Test 注解 来 标注 这 是 一 个 测试 方法 。 

(7) : 调用 被 测试 函数 getArrayList() 。 

(8) : 使 用 JUnit 的 Assert 类 的 API 进行 断言 操作 。 


1.2.2 扩展 函数 与 扩展 属性 


扩展 函数 与 扩展 属性 的 “好 玩 ” 之 处 在 于 ， 可 以 在 不 修改 原来 类 的 条 件 下 自 定义 函数 
和 属性 ， 使 它们 表现 得 就 像 是 属于 这 个 类 一 样 。 例 如 ， 我 们 给 String 类 型 扩展 一 个 返回 字 
符 串 首 字母 的 firstCharO) 函 数 ， 代 码 如 下 : 


fun String.firstChar(): String { //#String 类 扩展 一 个 firstChar () 函数 


if (this.length == 0) { // 这 里 的 this 代表 调用 者 对 象 
EE 

} 

return this[0].toString() // 返 回 下 标 为 0 的 字符 并 转 成 String 类 型 
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然后 就 可 以 在 代码 中 直接 这 样 调 用 该 函数 : 
"abe" .firstChar () // 调 用 我 们 自 定义 的 扩展 函数 
代码 显得 相当 简洁 。 


1.23 不 可 空 类 型 与 空 安全 


使 用 Kotlin 编程 比 Java 更 加 安全 ， 至 少 在 空 指针 问题 上 写 起 代码 来 会 更 加 “开心 ”。 
Kotlin 中 引入 了 不 可 空 类 型 与 可 空 类 型 来 明确 声明 一 个 变量 是 否 可 能 为 null， 同 时 在 编译 
期 通过 类 型 是 否 匹配 来 检查 空 指针 异常 ,大 大 降低 了 空 指针 异常 出 现 的 概率 。 同 时 ,Kotlin 
还 提供 了 Elvis 操作 符 、 安 全 调用 符 等 极 简 的 语法 格式 ， 使 开发 者 从 Java 的 null 防御 式 编 
程 中 被 解放 出 来 。 例 如 下 面 的 这 段 代码 : 

>>> var a = "abc" // 声 明 一 个 字符 串 , 编 译 器 会 默认 推断 变量 a 的 类 型 为 不 可 空 的 String 


>>> a = null // 不 可 空 类 型 不 能 赋值 为 null 
error: null can not be a value of a non-null type String 
a = null 


D 


当 声 明了 不 可 空 类 型 String 的 变量 a 后 ， 在 后 面 使 用 变量 a 的 代码 中 就 不 能 给 a 赋值 
为 null。 如 果 给 a 赋值 null， 编 译 器 会 直接 报错 。 而 这 个 时 候 ， 如 果 我 们 想 声 明 一 个 可 空 
的 String 类 型 ， 可 以 这 样 写 : 

var b:String? = "abc" // 声 明 一 个 可 空 的 String? 类 型 


但 是 这 个 时 候 ， 如 果 想 调用 变量 b 的 方法 ， 就 不 能 直接 像 下 面 这 样 写 了 : 


>>> b.length // 可 空 类 型 不 能 直接 调用 方法 ， 需 要 使 用 安全 调用 符 ? .或 者 断言 调用 !!. 
error: only safe (?.) or non-null asserted (!!.) calls are allowed on a 
nullable receiver of type String? 

b. length 


A 


我 们 可 以 看 到 ， 上 面 的 代码 运行 报错 : 
可 空 类 型 string? 只 有 使 用 安全 调用 符 (?.) 和 非 空 断言 调用 符 (!) 才 人 允许 调用 其 方法 。 


WREIDE 中 会 直接 提示 报错 ,编译 不 通过 。 上 面 的 代码 可 以 使 用 安全 调用 符 进行 如 
下 改写 : 

>>> b?.length // 使 用 安全 调用 符 

3 

>>> b=null 


>>> b?.length //null 对 象 使 用 安全 调用 符 访问 length 属性 ， 直 接 返 回 null 
null 


这 个 问号 确实 非常 简洁 易 懂 ， 同 时 能 够 时 刻 提 醒 我 们 : 这 个 调用 者 有 可 能 是 null 的 。 
这 个 语法 明显 比 Java 8 中 引入 的 Optional<String> 更 加 简单 、 直 接 。 


Kotlin 从 入 门 到 进 阶 实战 


1.2.4 一 等 函数 支持 


在 Kotlin 中 函数 是 第 一 等 类 型 (fist class) : 我 们 可 以 将 函数 像 值 一 样 传递 ， 函 数 可 
以 作为 男 一 个 函数 的 返回 值 。 我 们 通常 称 之 为 “一 等 函数 〈first order functions) ”支持 。 
例如 ， 下 面 是 一 个 把 函数 作为 参数 传递 给 函数 的 Lambda 表达 式 的 例子 : 


>>> val list = listOf(1, 2, 3, 4, 5, 6, 7) VEH- TAE List 
>>> list.filter{ it%3!=0 } 
// 调 用 filter 函数 ， 传 入 一 个 Lambda 表达 式 { it%3!=0 } 作 为 参数 
(le Ele Si TH 
其 中 ，f{it%3!=0} 是 一 个 Lambda 表达 式 ， 它 判断 元 素 是 否 能 够 被 3 整除 。 如 果 满 足 此 
条 件 就 留 下 该 元 素 ， 否 则 过 滤 掉 。 关 于 函数 式 编程 的 内 容 将 在 第 5 章 中 介绍 。 


1.2.5 智能 类 型 推断 


在 上 面 的 诸多 例子 中 ， 可 以 看 到 在 声明 变量 的 时 候 并 没有 显 式 指定 它 的 类 型 。Kotlin 
编译 器 会 自动 推断 出 其 类 型 。 
上 面 介绍 的 只 是 Kotlin 诸多 优秀 特性 中 的 一 部 分 ， 更 多 内 容 且 看 后 面 的 章节 讲解 。 


13 编程 哲学 


“我 们 认为 Kotlin 的 定位 是 一 种 现代 化 工业 语言 : 它 专注 于 代码 重用 和 可 读 性 的 弹性 
抽象 ， 以 及 面向 早期 错误 侦 测 和 明确 捕获 维护 与 清理 的 意图 这 些 问 题 的 静态 类 型 安全 性 。 
Kotlin 最 重要 的 使 用 场景 之 一 是 对 于 一 个 庞大 的 Java 代码 库 ， 其 开发 者 需要 一 个 更 棒 的 语 
言 : 你 能 够 将 Java 和 Kotlin 自由 混合 ,迁移 可 以 是 渐进 式 的 , 不 需要 一 下 子 对 整个 代码 库 
进行 改变 。” 

“Kotlin 虽 在 成 为 一 种 面向 工业 的 面向 对 象 语言 ， 而 且 是 一 种 比 Java 更 好 的 语言 ， 但 
仍然 可 以 与 Java 代码 完全 互 操作 ， 允 许 企业 逐步 从 Java 迁移 到 Kotlin, ” 

一 一 Andrey Breslav，Kotlin 创始 人 

编程 的 真正 问题 在 于 ， 如 何 把 人 类 脑子 里 对 问题 的 解决 方案 “有 具 化 ”到 机 器 世界 ， 而 
这 个 “有 具 化 ”的 过 程 正 是 编程 语言 所 要 表达 的 东西 。 如 何 富有 表现 力 并 且 安 全 简洁 地 表达 ， 
这 是 所 有 编程 语言 所 要 解决 的 问题 。 让 人 类 能 够 尽 可 能 “自然 地 ”和 计算 机 进行 沟通 交流 ， 
这 一 直 是 促使 人 们 提高 编程 语言 抽象 层次 的 主要 目标 之 一 。 很 显然 的 一 个 事实 就 是 ， 与 用 
机 器 语言 写 的 低层 次 结构 代码 相 比 ， 用 编译 语言 写成 的 高 层次 结构 代码 更 接近 于 人 类 进行 
思考 时 所 用 的 概念 。 

Kotlin 设计 了 一 个 “ 归 一 化 ”的 类 型 系统 〈 一 切 类 型 此 是 引用 类 型 ) ， 纯 天 然 地 设置 
了 一 道 空 指针 的 屏障 ， 使 得 Kotlin H Java 更 加 安全 可 靠 。Kotlin 还 引入 了 类 型 推断 、 一 等 
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支持 函数 式 编程 、Lambda、 高 阶 函数 、 类 的 扩展 函数 与 属性 、DSL 等 诸多 特性 ， 使 得 我 们 
可 以 编写 简单 且 高 效 的 代码 ， 更 加 专注 地 投入 到 业务 逻辑 的 实现 上 。 

优秀 的 程序 员 当 然 会 选择 使 用 Kotlin 这 些 更 加 先进 的 特性 ， 因 为 它们 有 助 于 更 直接 地 
表达 观点 ， 而 且 也 没有 额外 的 开销 ， 何 乐 而 不 为 呢 ? 


LA 学 习 工 具 
工 欲 善 其 事 ， 必 先 利 其 器 。 本 节 我 们 简单 介绍 一 下 学 习 Kotlin 的 工具 平台 。 
1.4.1 云端 IDE 


如 果 你 想 快 速 体 验 一 下 Kotlin， 只 需要 通过 浏览 器 打开 云端 IDE， 网 址 为 
https://try.kotlinlang.org/， 如 图 1-1 所 示 。 


Examples ` Hello, world! ` Simplest version ` Simplest version kt 


Examples a Fe B- NM -|b 
4 Peng Bt .| TEE 


4 Hello, world! 


E Simplest version 


dec area package: Level, fumetto ealn vhi urns Unit and takes 


2 s Un 
下 3S an Array of strings 2s a paraneter. Note that semicolons are optional. 


D Reading a name from t. = 
D Reading many names f. 5 fun minlar ros: Arrayestrings) { 
7 tn"Hello, world!" 
E Amutti-language Hello D 
D An object-oriented Hello 

» Basic syntax walk-through 

» Destructuring declarations ar 

» Delegated properties 

» Callable references 

» Longer examples 

» Problems 

> Canvas 
» Kotlin Koans 0/42 
» Kotlin in Action 
» Advent of Code # (log in) 


(log in) 


Don-the-fly type checking 


1-1 Kotlin 云端 IDE 


在 这 里 可 以 快速 感受 Kotlin 语言 到 底 是 什么 样 的 ， 但 是 这 里 不 支持 代码 智能 提示 及 自 
动 补 全 等 功能 


1.4.2 命令 行 REPL 


有 时 候 我 们 并 不 需要 打开 IDE 来 做 一 些 事情 。 打 开 IDE 是 件 很 麻烦 的 事情 ， 在 某 些 
场景 下 ， 开 发 者 比较 喜欢 命令 行 。 


Kotlin 从 入 门 到 进 阶 实战 


使 用 命令 行 环境 ， 我 们 可 以 方便 地 使 用 Kotlin REPL (Read-Eval-Print-Loop， 交 互 式 编 
程 环境 ) 。REPL 可 以 实时 编写 Kotlin 代码 ， 并 查看 运行 结果 。 通 常 ，REPL 交互 方式 可 以 
用 于 调试 、 测 试 及 测试 某 种 效果 。 

如 果 你 想 在 本 地 快速 测试 一 个 简短 的 Kotlin 代码 ， 可 以 使 用 命令 行 REPL。Kotlin 是 
运行 在 JVM 环境 下 的 语言 。 首 先 我 们 要 有 IDK 环境 〈 此 处 省 略 Java 环境 配置 ) 。 

目前 ，Kotlin 正式 发 布 的 最 新 版 本 是 1.1.50。 首 先 去 下 载 Kotlin 运行 环境 安装 包 : 
https://github.com/JetBrains/kotlin/releases/download/v1.1.50/kotlin-compiler-1.1.50.zip. 

解压 完 kotlin-compiler-1.1.50.zip， 放 到 相应 的 目录 下 。 然 后 配置 系统 环境 变量 : 

export KOTLIN HOME=/Users/jack/soft/kotlinc 

export PATH=$PATH:$KOTLIN HOME/bin 

执行 source ~/bashrc， 在 命令 行 输入 kotlinc， 即 可 进入 KotlinREPL 界面 。 


$ kotlinc 

Welcome to Kotlin version 1.1.50 (JRE 1.8.0 40-b27) 

Type :help for help, :quit for quit 

>>> println("Hello,World!") // 在 REPL 中 直接 打印 "Hello,World!" 


Hello,World! 
>>> import java.util.Date // 在 REPL 中 导入 需要 使 用 的 Java 中 的 Date 类 
>>> Date() // 创 建 一 个 Date 对 象 ， 输 出 当前 的 时 间 


Wed Jun 07 14:19:33 CST 2017 


1.4.3 使 用 IDEA 


如 果 想 有 学 习 Kotlin 的 相对 较 好 的 体验 ， 那 么 建议 读者 不 要 使 用 eclipse。 毕 竟 Kotlin 
是 JetBrains 家 族 的 “ 亲 儿 子 ”， 跟 IntelliJ IDEA 是 “ 血 浓 于 水 ” 啊 。 

我 们 使 用 IDEA 新 建 Kotlin Gradle 项 目 ， 选 择 Java，Kotlin(Java) 框 架 支持 ， 如 图 1-2 
所 示 。 


Project SOK: fe 1.8 Uava version “1 8.04 


‘Additional Ubranes and Frameworks: 


图 1-2 使 用 IDEA 新 建 Kotlin Gradle 项 目 
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新 建 完 项 目 后 ， 我 们 写 一 个 HelloWorld.kt 类 ， 代 码 如 下 : 


package com.easy.kotlin 


import java.util.Date //(1) 导入 Date 类 
import java.text.SimpleDateFormat //(2) 导入 SimpleDateFormat 类 


fun main(args: Array<String>) { 

println("Hello, world!") // 打 印 函数 

println(SimpleDateFormat ("yyyy-MM-dd HH:mm:ss") .format (Date())) 

// (3) 直接 使 用 Java 中 的 API, WAR Java 类 似 
} 
代码 说 明 如 下 。 
(1) : SA Java 中 的 Date 类 。 
(2) : 导入 Java 中 的 SimpleDateFormat 类 。 
G): 直接 使 用 Java 中 的 API. Kotlin 调用 Java 的 语法 对 我 们 来 说 很 熟悉 了 ， 直 接 运 
行 HelloWorld.kt， 输 出 结果 如 下 : 


Hello, world! 
2017-05-29 01:15:30 


15 为 什么 要 学 Kotlin 


现在 的 编程 语言 已 经 足够 多 了 , 为 什么 我 们 还 需要 更 多 的 语言 ? Java 已 经 足够 强大 了 ， 
为 什么 我 们 还 需要 Kotlin, Scala 这 样 的 语言 呢 ? 

其 实 ， 如 果 我 们 仔细 想 想 ， 会 发 现 这 个 问题 本 身 的 逻辑 就 不 成 立 。 例 如 ， 我 们 能 这 样 
说 吗 一 一 前 鸡 排 已 经 足够 好 吃 了 ， 为 什么 我 们 还 要 去 吃 前 牛排 呢 ? 

从 最 早 的 机 器 语言 (01 机 器 码 ， 汇 编 语言 ) 到 高 级 语言 (LISP. BASIC, Pascal. C, 
C+, Java, Haskell 等 ) ， 再 到 现代 编程 语言 (Go、Swift、Scala、Kotlin 等 ) ， 编 程 语 言 
的 演化 过 程 可 谓 是 百花 齐 放 、 百 家 争鸣 。 

最 早 的 编程 语言 是 ot 机 器 码 (Machine Code) ， 那 个 时 候 的 程序 员 要 会 用 0 和 1 表示 
一 切 ! 

后 来 人 们 可 以 把 一 些 常用 的 指令 操作 单独 抽象 出 来 ， 用 特定 的 关键 字 来 映射 01 机 器 
码 序列 ， 而 这 就 是 汇编 语言 ， 这 可 以 算 作 是 编程 语言 过 程 中 的 第 一 次 抽象 封装 。 也 许 汇编 
语言 的 主要 意义 不 在 于 它 与 机 器 语言 之 间 并 不 显著 的 差别 ， 而 是 这 样 的 一 种 思路 : 程序 完 
全 可 以 在 不 同 的 层次 上 编制 ! 人 们 可 以 用 机 器 语言 写 一 个 “翻译 程序 ”， 从 而 可 以 在 一 个 
更 高 层次 上 进行 编程 。 

后 来 汇编 语言 用 久 了 ， 人 们 也 逐渐 发 现 了 使 用 汇编 语言 的 缺点 : 可 移植 性 差 。 汇 编 代 
码 中 是 大 量 的 字 节 指令 码 ， 而 且 必须 一 步 步 地 告诉 计算 机 每 一 步 要 怎么 做 ， 如 果 其 中 的 一 
个 步骤 出 错 ， 那 么 执行 结果 将 是 程序 员 们 意 想不到 的 ! 使 用 汇编 语言 编程 ， 极 易 在 子 程序 
调用 过 程 中 导致 寄存 器 内 容错 误 ， 而 且 调试 程序 也 很 困难 。 程 序 在 正常 运行 时 ， 我 们 基本 
不 会 过 多 地 关心 和 想象 它 的 活动 结构 和 层次 空间 。 只 有 当 程 序 出 现 bug 或 者 崩溃 的 时 候 ， 
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我 们 才 会 在 不 同 层次 上 思考 和 想象 程序 运行 的 具体 细节 。 而 这 其 中 的 出 错 信息 将 变 得 至 关 
重要 。 例 如 ， 一 个 除法 操作 ， 遇 到 除数 为 0 的 情况 程序 将 暂停 运行 ， 并 把 错误 抛 给 程序 员 。 
下 面 是 不 同 层次 上 的 debug 信息 : 

机 器 语言 层 : 程序 运行 异常 终止 于 11110000010001001 地 址 ; 

汇编 语言 层 : 程序 运行 异常 终止 于 DIV 指令 ; 

编译 语言 层 : 程序 运行 异常 终止 于 代码 行 256: (a+b)/c 处 。 

上 面 的 信息 中 ， 显 而 易 见 的 是 层次 越 高 ， 越 容易 被 人 类 大 脑 所 理解 。 

在 高 级 语言 中 ， 所 有 参数 都 必须 严格 匹配 其 类 型 ， 这 样 就 不 会 出 现 寄存 器 内 容错 误 的 
情况 。 高 级 语言 就 是 为 了 解决 汇编 语言 的 这 些 问题 进行 的 更 高 一 层 的 抽象 与 封装 。 这 层 封 
装 就 是 编译 器 。 编 译 器 所 要 解决 的 问题 就 是 如 何 构造 一 个 系统 ， 使 它 可 以 接收 当前 层次 的 
描述 ， 然 后 从 中 生成 另 一 个 层次 上 的 描述 。 通 常 来 说 ， 设 计 一 门 语言 相对 容易 ， 而 实现 这 
门 语言 的 编译 器 则 是 比较 复杂 的 。 编 译 器 制定 了 一 系列 的 协议 规范 、 语 法 规则 等 ， 只 要 程 
序 员 按 照 这 个 协议 规范 来 编程 , 编译 器 就 可 以 将 高 级 语言 的 源 代码 翻译 成 对 应 CPU 指令 集 
上 的 汇编 语言 代码 。 高 级 语言 不 要 求 程序 员 掌握 计算 机 的 硬件 运行 原理 ， 只 要 写 好 上 层 代 
码 即 可 。 著 名 的 高 级 语言 有 BASIC、Fortran (公式 翻译 ) 、COBOL (通用 商业 语言 ) 、C、 
Pascal (结构 化 编程 语言 ) ADA (通用 程序 设计 语言 ) 等 。 

尽管 C 语言 (1972，Dennis MacAlistair Ritchie， 启 发 语言 有 B 语言 、 汇 编 、 ALGOL68 
等 ) 已 经 足够 普及 且 非 常 强大 ， 但 是 之 后 还 是 出 现 了 针对 C 语言 进行 改进 和 功能 扩展 的 新 
语言 一 一 C++ 语言 (1979，Bjame Stroustrup) 。C++ 语 言 集成 了 C 语言 的 特性 ， 然 后 加 入 
了 面向 对 象 程序 设计 的 特性 支持 。 和 汇编 语言 不 同 的 是 ，C 语言 的 语句 和 机 器 语言 的 指令 
之 间 不 再 是 简单 的 一 一 对 应 关系 ， 不 过 毫 无 疑问 的 是 ,仍然 存在 从 C 语言 代码 到 机 器 语言 
代码 的 映射 关系 ， 但 是 这 种 关系 要 比 从 汇编 语言 到 机 器 语言 之 间 的 关系 复杂 多 了 。 而 完成 
这 个 映射 过 程 翻译 的 程序 ， 我 们 就 称 之 为 “编译 器 ”。 

而 C/C++ 语言 最 大 的 一 个 问题 就 是 “一 切 都 会 尖 叫 着 停止 ”， 因 为 它们 使 用 了 直接 操 
纵 内 存 的 指针 。 一 旦 因为 使 用 指针 而 出 现 了 内 存 错误 ， 系 统 核心 就 会 月 溃 。 

有 没有 一 种 语言 可 以 控制 这 样 的 风险 呢 ? 

后 来 的 James Gosling 在 1995 年 开发 出 的 Java 语言 继承 了 C 和 C++ 语言 的 优点 , MA 
了 C++ 语言 里 的 指针 操作 、 手 动 管理 内 存 、 多 继承 等 诸多 复杂 而 并 不 实用 的 功能 特性 ， 引 
入 了 划时代 的 Java 虚拟 机 (Java Virtual Machine, JVM) 。JVM 是 一 种 虚拟 的 计算 机 ， 从 
结构 上 看 , 它 与 实际 的 计算 机 架构 相似 ,JVM 的 作用 是 使 得 一 台 实 际 的 机 器 能 够 运行 Java 
字 节 码 (bytecode) 。 引 用 Java 之 父 James Gosling 的 话 就 是 

“大 部 分 人 大 谈 特 谈 Java 语言 ， 这 对 于 我 来 说 也 许 听 起 来 很 奇怪 ， 但 是 我 无 法 不 去 在 
意 。JVM 才 是 Java 生态 系统 的 核心 啊 。 我 真正 关心 的 是 Java 虚拟 机 的 概念 ， 因 为 是 它 把 
所 有 的 东西 都 联系 在 了 一 起 ; 是 它 造 就 了 Java 语言 ; 是 它 使 得 事物 能 在 所 有 的 异 构 平 台 上 
得 到 运行 ;也 还 是 它 使 得 所 有 类 型 的 语言 能 够 共存 。” 

首先 , JVM 实现 了 Java 的 可 移植 性 。 另外 , JVM 里 面 实 现 了 一 个 垃圾 收集 器 (Garbage 
Collector, GC) 来 管理 内 存 ，GC 对 保证 系统 的 可 靠 性 和 安全 性 非常 实用 有 益 。 同 时 ，JVM 
还 葛 定 了 一 个 庞大 的 语言 生态 的 基础 。 
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Java 是 互联 网 时 代 当 之 无 愧 的 最 流行 的 开发 语言 。 经 过 20 多 年 的 积累 和 沉淀 ，Java 
生态 拥有 了 很 多 优秀 的 开源 社区 ,如 Apache 和 Spring。 有 了 这 些 框 架 , 我 们 可 以 更 加 专注 
业务 的 实现 。 

Java 语言 也 有 不 好 的 一 面 ， 简 单列 举 如 下 。 


1. 检查 异常 (Checked Exceptions) 


检查 异常 会 在 编译 时 强制 执行 try catch 处 理 ， 同 时 还 需要 进行 某 种 排序 处 理 。 检 查 异 
常 是 一 个 失败 的 实践 ， 几 乎 所 有 的 主要 API 提供 者 都 反对 可 检查 异常 。Kotlin PRF T 
查 异 常 。 

2. 基本 类 型 和 数组 


Java 的 这 个 设计 保留 了 字 节 码 的 底层 细节 ， 违 反 了 “凡事 皆 为 对 象 ” 的 原则 ， 如 泛 型 
无 法 包容 基本 类 型 就 是 一 个 经 典 的 例子 。 这 也 使 得 Java 的 类 型 系统 显得 不 是 那么 地 简单 统 
一 。 比 较 好 的 方案 是 ， 源 代码 不 用 直接 使 用 基本 类 型 或 者 数组 ， 由 编译 器 (或 者 TVM) 来 
决定 是 否 可 以 帮 你 对 其 进行 优化 ， 而 Kotlin 正 是 这 么 做 的 。 


3. 静态 变量 (Static) 

静态 方法 经 常会 导致 需要 显 式 地 定义 接口 ， 从 而 使 得 API 更 加 复杂 。 一 个 更 好 的 办 法 
就 是 采用 单 例 对 象 ， 单 例 对 象 在 大 多 数 情况 下 的 表现 与 静态 对 象 差 不 多 ， 但 是 可 以 像 一 个 
对 象 一 样 被 传递 。Kotlin 中 提供 了 object 单 例 对 象 。 

4. 泛 型 


Java 泛 型 本 身 就 很 复杂 ， 当 使 用 ?exends 和 ?super 等 变种 句 型 时 就 变 得 尤为 复杂 , 非常 
容易 搞 错 。 这 个 问题 在 Effective Java 一 书 中 提出 了 PECS(Producer Extends Consumer Super) 
的 建议 ，Kotlin 直接 使 用 了 这 个 方案 。 


5. 空 指针 异常 (NPE) 


在 Java 中 我 们 不 得 不 写 一 堆 防御 代码 来 避免 令 人 头疼 的 NPE。 Kotlin 中 引入 了 可 空 类 
型 与 安全 调用 符 、Elvis 操作 符 等 特性 来 实现 空 安 全 ， 这 部 分 内 容 将 在 第 3 章 中 介绍 。 


6. 一 堆 getter'setter 单 调 元 长 的 样板 代码 
例如 ， 下 面 的 Person Bean 类 : 


class Person { // 用 Java 声明 一 个 Person Bean 类 
Integer id; 
String name; 


public Integer getId() { 
return id; 


} 


public void setId(Integer id) { 
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this.id = id; 
} 


public String getName () { 
return name; 


上 


public void setName(String name) { 
this.name = name; 


} 


public Person(Integer id, String name) { 
this.id = id; 
this.name = name; 
} 
} 
在 Kotlin 中 我 们 可 以 使 用 数据 类 ， 代 码 如 下 : 
data class Person (val id: Int, val name: String) 
// 使 用 Kotlin 的 数据 类 声明 一 个 Person Bean 类 
关于 数据 类 的 内 容 ， 将 在 第 4 章 中 介绍 。 
7. 不 容易 传递 函数 


Java 中 没有 提供 一 等 函数 类 型 ， 函 数 式 编程 (FP) 只 能 通过 使 用 接口 类 型 以 及 多 态 特 
性 “曲线 ”来 实现 。Java 会 将 每 一 个 算法 (方法 ) 都 放 入 类 中 ,这 种 限制 会 出 现 这 样 的 “ 荒 
唐 ” 事 : 我 们 只 是 想 要 实现 一 个 函数 算法 ， 而 这 个 时 候 必须 还 要 给 出 一 个 类 来 放置 这 个 方 
法 ; 同样 ， 如 果 在 其 他 地 方 要 调用 这 个 方法 ， 必 须 通过 创建 该 类 来 实现 调用 。 在 Kotlin 中 
直接 提供 了 一 等 函数 类 型 (First-Class Function Type) ， 其 跟 普通 类 型 一 样 ， 函 数 类 型 可 以 
作为 值 来 传递 ， 也 可 以 作为 返回 值 。 

此 外 ， 还 有 其 他 的 经 验 教 训 ， 上 面 所 述 只 是 其 中 的 一 部 分 。 

不 可 否认 的 是 ，C、C++ 和 Java 语言 都 是 非常 优秀 的 编程 语言 。 但 是 事物 总 是 不 断 发 
展 变化 的 ,就 像 C++ 语言 是 对 C 语言 的 继承 与 发 展 , Java 语言 是 对 C++ 语言 的 继承 与 改造 ， 
而 Kotlin 语言 也 是 对 Java 语言 的 继承 与 变革 。 


1.6 JVM 语言 生态 


下 面 是 一 个 来 自 Java 官网 文档 (http://docs.oracle.com/javase/8/docs/) 里 的 一 张 Java 
技术 模块 架构 图 ， 如 图 1-3 所 示 。 

为 了 在 JVM 上 正确 运行 我 们 的 程序 ， 只 需要 按照 规范 生成 正确 的 class 文件 ， 然 后 加 
RE JVM 中 执行 文件 中 指定 的 操作 字 节 指令 码 (byte code) 即 可 。 

在 过 去 20 多 年 的 发 展 历程 中 (1991—2017 年 ， 如 果 算 上 最 初 的 称 为 Oak 语言 的 Java 
前 生 ) ，Java ii. JVM, API 库 和 框架 、 应 用 工具 和 Web 服务 器 的 速度 、 稳 定性 和 功能 
方面 在 不 断 发 展 ， 已 被 公认 为 是 开发 企业 级 服务 的 首选 技术 栈 。 
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图 1-3 Java 技术 模块 架构 图 


JVM 最 初 是 为 了 支持 Java 编程 语言 。 然 而 随 着 时 间 的 推移 ， 越 来 越 多 的 语言 被 改编 、 
设计 并 运行 在 JVM 上 。 除 了 Java 语言 外 ， 比 较 知名 的 JVM 上 的 编程 语言 还 有 Groovy、 
Scala 和 Clojure 等 。 


JVM 上 主流 编程 语言 历史 时 间 轴 概览 如 图 1-4 所 示 。 
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1-4 JVM 上 主流 编程 语言 历史 时 间 轴 概览 
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AQHA: 计算 机 中 的 所 有 问题 ， 都 可 以 通过 向 上 抽象 封装 一 层 来 解决 。 


Java 虚拟 机 对 各 个 平台 而 言 ,实质 上 是 各 个 平台 上 的 一 个 可 执行 程序 。 例 如 在 Windows 
平台 下 ，Java 虚拟 机 对 于 Windows 而 言 ， 就 是 一 个 java.exe 进程 而 已 。 
通常 情况 下 ， 在 JVM 平台 上 从 源 代码 编译 到 JVM 上 执行 的 整体 过 程 如 图 1-5 所 示 。 


TF ES E | =] 


Kotlinc 编 译 器 Scalac 编 译 器 
javac 编 译 器 Groovyc 编 译 器 


@HelloWorldKt.class 


pa cas 编译 输出 遵循 
rser | SS 
@HTMLParserkt.class INM 可 执行 
@HttpClientkt.class 文件 规范 的 
@HttpProxy.class class 文 件 


E InterfaceinvokeDemo.class 


读 取 加 载 到 JVM 中 


Mac OS 实 现 Windows 实 现 


Linux 实 现 


A 


jdk-8u144-macosx-x64.dmg jdk-8u144-linux-x64.tar.gz jdk-8u144-windows-x64.exe 


图 1-5 在 JVM 平 台 上 从 源 代码 编译 到 JVM 上 执行 的 整体 过 程 
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其 中 ， 运 行 在 JVM 上 的 字 节 码 文件 是 不 依赖 于 硬件 和 操作 系统 的 二 进 制 格式 的 文件 。 
依赖 硬件 和 操作 系统 的 部 分 ， 由 JVM 分 别 在 这 些 平台 上 来 实现 。 例如 ，JDK 8 的 各 个 平台 
的 软件 版 本 如 图 1-6 所 示 。 


Product / File Description File Size Download 
Linux ARM 32 Hard Float ABI 77.89 MB #jdk-8u144-linux-arm32-vip-hfit.tar.gz 
Linux ARM 64 Hard Float ABI 74.83 MB #jdk-8u144-linux-arm64-vip-hfit.tar.gz 
Linux x86 164.65 MB #jdk-8u144-linux-i586.rpm 
Linux x86 179.44 MB #jdk-8u144-linux-i586.tar.gz 
Linux x64 162.1 MB #jdk-8u144-linux-x64.rpm 
Linux x64 176.92 MB #jdk-8u144-linux-x64.tar.gz 
Mac OS X 226.6 MB_ jdk-8u144-macosx-x64.dmg 
Solaris SPARC 64-bit 139.87 MB jdk-8u144-solaris-sparcv9.tar.Z 
Solaris SPARC 64-bit 99.18 MB #jdk-8u144-solaris-sparcv9.tar.gz 
Solaris x64 140.51 MB #jdk-8u144-solaris-x64.tar.Z 
Solaris x64 96.99 MB #jdk-8u144-solaris-x64.tar.gz 
Windows x86 190.94 MB #jdk-8u144-windows-i586.exe 
Windows x64 197.78 MB #jdk-8u144-windows-x64.exe 


图 1-6 JDK 8 的 各 个 平台 的 软件 版 本 


我 们 经 常 说 的 Java 语言 是 平台 无 关 的 ， 即 跨 平台 的 ， 其 实 针 对 从 Java, Scala, Kotlin, 
Groovy 等 的 源 代码 到 JVM 字 节 码 这 一 层 是 平台 无 关 的 。 

但 是 ， 真 正 把 JVM 字 节 码 通 过 解释 器 映射 到 不 同 平台 操作 系统 ，CPU 硬件 架构 ) 
上 时 ,JVM 就 必须 针对 各 个 平台 实现 一 套 解释 器 。 只 是 这 一 层 通 过 抽象 封装 ,对 Java, Scala, 


Kotlin、 


Groovy 程序 员 而 言 已 经 完全 透明 ， 无 须 再 做 相关 的 工作 而 已 。 


在 下 一 代 普 遍 可 接受 语言 (next mass-appeal language) 中 ， 人 的 因素 应 该 是 至 关 重要 
的 。 在 功能 方面 ， 应 该 具备 如 下 特性 : 


ooooocooocoocen 


类 C 的 语法 (容易 被 大 众 程序 员 所 接受 ， 很 好 用 也 很 熟悉 〉; 
静态 类 型 (动态 类 型 过 于 松散 并 且 性 能 有 限 ， 不 适用 于 大 型 项 目 ); 
遵循 面向 对 象 程序 设计 OOP 思想 ， 同 时 支持 函数 式 编程 CFP) ; 
反射 (从 而 避免 静态 类 型 限制 ); 

属性 (getter 和 setter 实在 是 太 让 人 讨厌 了 ) ; 

高 阶 函 数 ，Lambda 与 闭 包 ; 

Null 判断 〈 提 供 一 个 判断 变量 能 否 为 null 的 方式 ) ; 

并 发 协 程 ; 

模块 化 ; 

完善 的 工具 支持 ; 

可 扩展 性 (语言 的 设计 具备 很 好 的 可 扩展 性 〉; 


程序 语言 设计 其 实 堪 比 艺术 品 设计 ， 每 个 开发 者 的 喜好 与 审美 都 不 同 ， 有 自己 的 风格 
与 特征 ， 所 以 设计 出 一 门 好 的 编程 语言 确实 不 容易 。 

生命 只 有 一 次 ， 所 以 不 要 去 做 一 些 重复 无 聊 的 事情 。 能 交 给 计算 机 做 的 ， 就 尽量 交 给 
计算 机 去 做 。 未 来 ， 人 工 智 能 将 取代 大 部 分 的 重复 手工 劳动 ， 将 大 大 解放 人 类 的 劳动 力 ， 
从 而 使 得 人 类 能 够 花 更 多 的 时 间 和 精力 去 创造 ， 去 创新 。 而 人 工 智能 的 本 质 ， 就 是 对 人 类 
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智能 的 抽象 建 模 。 人 类 设计 的 操作 系统 、 浏 览 器 、 办 公 软 件 、 画 图 设计 工具 、3D 建 模 软件 、 
电 商 系统 、 金 融 平台 、 社 交 APP， 不 就 是 另 一 种 层次 上 的 人 工 智 能 吗 ? 这 些 东西 ， 背 后 都 
是 01 的 映射 。 当 然 ，01 背后 是 物理 层次 量子 微观 的 世界 了 ， 更 加 奥妙 无 穷 。 

纵览 整个 计算 机 的 发 展 史 ， 最 重要 的 思想 非 “ 抽 象 ” 莫 属 。 一 层 层 的 抽象 封装 了 实现 
的 细节 ， 经 过 计算 机 技术 的 不 断 发 展 ， 到 了 今天 的 互联 网 ( 云 计算 ， 大 数据 ， 机 器 智能 ) 
时 代 。 

同时 ,程序 员 写 代码 从 最 初 的 拿 着 符号 表 在 纸 带 上 打 孔 ， 到 使 用 近似 自然 语言 的 高 级 
编程 语言 来 编程 (当然 背后 少不了 编译 器 、 解 释 器 ， 还 有 的 是 先 通过 虚拟 机 中 间 字 节 码 这 
一 层 , 再 通过 解释 器 映射 到 机 器 码 , 最 后 在 硬件 上 进行 高 、 低 电 平 的 超 高 频率 的 “舞蹈 ”) ， 
以 及 当今 各 种 库 API、 框 架 、 集 成 开发 工具 集 、 智 能 化 的 编码 提示 、 代 码 生 成 等 技术 ， 使 
得 现在 的 程序 员 ， 能 够 更 多 地 去 关注 问题 本 身 及 逻辑 的 实现 。 

从 只 有 少数 技术 人 员 会 用 的 命令 行 的 UNIX、DOS 操作 系统 ， 到 人 性 化 的 GUI (图 形 
用 户 界面 ) 操作 系统 ， 再 到 移动 互联 网 时 代 的 智能 设备 ， 计 算 机 与 互联 网 越 来 越 多 地 融入 
到 了 人 们 生活 的 方方面面 。 

正如 解决 数学 问题 时 通常 我 们 会 谈 “ 思 想 ”， 如 反 证 法 、 化 繁 为 简 等 ， 解 决 计算 机 问 
题 也 有 很 多 非常 出 色 的 “思想 ”。 之 所 以 称 为 思想 ， 是 因为 “思想 ”有 拓展 性 与 引导 性 ， 
可 以 解决 一 系列 问题 。 

解决 问题 的 复杂 程度 直接 取决 于 抽象 的 种 类 及 质量 。 将 结构 、 性 质 不 同 的 底层 实现 进 
行 封 装 ， 向 上 提供 统一 的 API 接口 ， 让 使 用 者 觉得 就 是 在 使 用 一 个 统一 的 资源 ， 或 者 让 使 
用 者 觉得 自己 是 在 使 用 一 个 底层 不 直接 提供 而 “虚拟 ”出 来 的 资源 。 


1.7 本 章 小 结 


本 章 主要 介绍 了 Kotlin 语言 的 特性 及 其 编程 哲学 ， 以 及 丰富 的 工具 集 的 支持 。JVM 语 
FEHR, M Kotlin 无 疑 是 当下 最 具 潜力 、 最 具 发 展 前 景 的 语言 。 第 2 章 中 我 们 将 学 习 
Kotlin 语言 的 语法 等 基础 知识 。 


#2 Kotlin 语法 基础 


人 与 人 之 间 往 往 通 过 语言 来 交流 沟通 ， 互 相 协作 。 人 与 计算 机 之 间 怎 样 “交流 沟通 ” 
We? 答案 是 编程 语言 。 一 种 语言 包含 词 、 短 语 、 句 子 、 文 章 等 ， 对 应 到 编程 语言 中 就 是 
关键 字 、 标 识 符 、 表 达 式 、 源 代码 文件 等 。 通 常 ， 一 种 编程 语言 的 基本 构成 要 素 如 图 2-1 
所 示 。 


类 型 系统 _@ 静 态 类 型 B@C、C++、C#、Java、Scala、Kotlin 等 解决 “操作 什么 ” 
一 一 一 一 一 一 动态 类 型 © JavaScript、PHP、Python、Ruby、Groovy 等 的 问题 


关键 字 (保留 字 ) 
顺序 结构 


语法 规则 ”四 流程 控制 方式 日 分 支 结构 这 else, when 
C 计 循环 结构 while for € 解决 “如 何 操作 ”的 问题 


领域 问题 -Doma in Problem 
解决 实际 生活 中 的 问题 


可 以 扩充 


图 2-1 一 种 编程 语言 的 基本 构成 要 素 


标准 库 SDK 


本 章 我 们 学 习 Kotlin 语言 的 基础 语法 。 
21 ”变量 和 标识 符 


变量 〈 数 据 名 称 ) 标识 一 个 对 象 的 地 址 ， 我 们 称 之 为 标识 符 。 而 具体 存放 的 数据 占用 
内 存 的 大 小 和 存放 的 形式 则 由 其 类 型 来 决定 。 

在 Kotlin 中 ， 所 有 的 变量 类 型 都 是 引用 类 型 。Kotlin 的 变量 分 为 val (不 可 变 的) 和 
var〈 可 变 的 ) 。 可 以 简单 理解 为 : 

口 val 是 只 读 的 ， 仅 能 一 次 赋值 ， 后 面 就 不 能 被 重新 赋值 ; 

O va 是 可 写 的 ， 在 它 生命 周期 中 可 以 被 多 次 赋值 。 

例如 ， 使 用 关键 字 val 声明 不 可 变 变 量 ， 代 码 如 下 : 

>>> val a:Int = 1 // 声 明 一 个 不 可 变 的 Int 类 型 的 变量 a 


> 
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另外 ， 还 可 以 省 略 后 面 的 类 型 mt， 直 接 声明 如 下 : 
>>> vala=1 // 根 据 值 1 编译 器 能 够 自动 推断 出 " Int ' 类 型 


>>> a 
1 


用 val 声明 的 变量 不 能 重新 赋值 ， 代 码 如 下 : 


>>> vala=1 


>>> a++ // 不 可 变 的 对 象 不 能 进行 重新 赋值 
error: val cannot be reassigned 
att 


a 


使 用 var 声明 可 变 变量 ， 代 码 如 下 : 


ET // 用 var 声明 一 个 可 变 的 变量 b 
So> b= 6 4 1 // 可 以 对 b 进行 重新 赋值 
>>> D 


2 


只 要 可 以 ， 应 尽量 在 Kotlin 中 首选 使 用 val 不 变 值 。 因 为 在 程序 中 大 部 分 地 方 只 需要 


使 用 不 可 变 的 变量 ， 而 使 用 val 变量 可 以 带 来 可 预测 的 行为 和 线程 安全 等 优点 。 


头 。 


变量 名 就 是 标识 符 。 标 识 符 是 由 字母 、 数 字 、 下 画 线 组 成 的 字符 序列 ， 不 能 以 数字 开 
下 面 是 合法 的 变量 名 。 


>>> val x=1 // 下 画 线 开头 
>>> val y = 2 // 普 通 字母 
>>> val ip addr = "127.0.0.1" // 中 间 带 下 画 线 
>>> x 

1 

>>> y 


2 
>>> ip addr 
127.0.0.1 


跟 Java 一 样 ，Kotlin 的 变量 名 区 分 大 小 写 ， 命 名 遵循 驼峰 式 命名 法 。 
2.2 ”关键 字 与 修饰 符 


通常 情况 下 ， 编 程 语 言 中 都 有 一 些 具有 特殊 意义 的 标识 符 是 不 能 用 作 变 量 名 的 ， 这 些 


具有 特殊 意义 的 标识 符 叫做 关键 字 (又 称 保留 字 ) ， 编 译 器 需要 针对 这 些 关键 字 进行 词法 
分 析 ， 这 是 编译 器 对 源码 进行 编译 的 基础 步骤 之 一 。 


Kotlin 中 的 修饰 符 关 键 字 主要 分 为 : 类 修饰 符 、 成 员 修饰 符 、 访 问 权 限 修饰 符 、 协 变 


逆 变 修饰 符 、 函 数 修饰 符 、 属 性 修饰 符 、 参 数 修饰 符 、 有 具体 化 类 型 修饰 符 等 。 这 些 修饰 符 
关键 字 如 表 2-1 一 表 2-8 所 示 。 
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% 2-1 Kotlin 中 的 类 修饰 符 


类 修饰 符 说 AA 
abstract 抽象 类 
final 不 可 被 继承 final 类 
enum 枚 举 类 
open 可 继承 open 类 
annotation 注解 类 
sealed 密封 类 
data 数据 类 
表 2-2 ”Kotlin 中 的 成 员 修 饰 符 
成 员 修饰 符 说 AA 
override 重 写 函 数 (方法 ) 
open 声明 函数 可 被 重 写 
final 声明 函数 不 可 被 重 写 
abstract 声明 函数 为 抽象 函数 
lateinit 延迟 初始 化 
表 2-3 Kotlin 中 的 访问 权限 修饰 符 
访问 权限 修饰 符 说 A 
private 私有 ， 仅 当前 类 可 访问 
protected 当前 类 以 及 继承 该 类 的 可 访问 
public 默认 值 ， 对 外 可 访问 
整个 模块 内 可 访问 (模块 是 指 一 起 编译 的 一 组 Kotlin 源 代码 文件 。 
internal 例如 ， 一 个 Maven 工程 ， 或 Gradle 工程 ， 通 过 Ant 任务 的 一 次 调 
用 编译 的 一 组 文件 等 ) 
表 2-4 Kotlin 中 的 协 变 逆 变 修饰 符 
协 变 逆 变 修饰 符 说 AB 
in 消费 者 类 型 修饰 符 ，outT 等 价 于 ? extends T 
out 生产 者 类 型 修饰 符 ，inT 等 价 于 ? superT 
表 2-5 Kotlin 中 的 函数 修饰 符 
函数 修饰 符 说 AA 
tailrec 尾 递归 
operator 运算 符 重 载 函 数 
infix 中 组 函数 。 例 如， 给 Int 定义 扩展 中 缀 函数 infix fun Int shl(x: Int): Int 
inline 内 联 函 数 
extemal 外 部 函数 
suspend 挂 起 协 程 函数 
表 2-6 ”Kotlin 中 的 属性 修饰 符 
属性 修饰 符 AA 


const 


常量 修饰 符 
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参数 修饰 符 


表 2-7 Kotlin 中 的 参数 修饰 符 
说 明 


变 长 参数 修饰 符 


vararg 


noinline 


不 内 联 参数 修饰 符 ， 有 时 ， 只 需要 将 内 联 函数 的 部 分 参数 使 用 内 联 Lambda， 其 他 的 参 
数 不 需 要 内 联 ， 可 以 使 用 noinline 关键 字 修饰 。 例 如 : inline fun foo(inlined: 0 -> Unit, 
noinline notInlined: 0 -> Unit) 


crossinline 


首先 ， 默 认 内 联 函 数 的 Lambda 表达 式 参数 是 允许 非 局 部 返回 的 ， 即 : 


fun outterFun() { 
innerFun { 
return // 支 持 直接 返回 outterFun 
} 
} 


而 使 用 crossinline 限制 Lambda 表达 式 直 接 非 局 部 return 返回 。 
这 样 做 的 原因 是 : 


一 些 内 联 函 数 可 能 调用 传 给 它们 的 不 是 直接 来 自 函数 体 , 而 是 来 自 另 一 个 执行 上 下 文 的 
Lambda 表达 式 参数 ， 如 来 自 局 部 对 象 或 嵌 套 函数 。 在 这 种 情况 下 ， 该 Lambda 表达 式 
中 也 是 禁止 直接 return 的 。 为 了 标识 这 种 情况 , 该 Lambda 表达 式 参 数 需要 用 crossinline 
修饰 符 标记 


# 2-8 Kotlin 中 的 具体 化 类 型 修饰 符 


具体 化 类 型 修饰 符 说 明 
reified 具体 化 类 型 参数 


一 个 crossinline 代码 实例 如 下 : 


inline fun f(crossinline body: () -> Unit) { // 内 联 函 数 £ 的 body 参数 是 一 个 Lambda 


val f = object: Runnable { 


} 


// 在 对 象 表达 式 中 使 用 body 参数 


override fun run() = body() // 参 数 标记 为 crossinline 后 , return 


操作 将 不 被 允许 


除了 上 面 的 修饰 符 关 键 字 之 外 ， 还 有 一 些 特殊 语义 的 关键 字 如 表 2-9 所 示 。 


表 2-9 Kotlin 中 的 关键 字 


关 键 字 说 明 
package 包 声 明 
as 类 型 转换 
typealias 类 型 别名 
class 声明 类 
this 当前 对 象 引用 
super 父 类 对 象 引用 
val 声明 不 可 变 变 量 
var 声明 可 变 变量 
fun 声明 函数 
for for 循环 
null 特殊 值 null 
true 真 值 
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续 表 

关 键 字 说 AR 

false 假 值 

is 类 型 判断 

throw 抛 出 异常 

return 返回 值 

break 跳出 循环 体 

continue 继续 下 一 次 循环 

object 单 例 类 声明 

if 逻辑 判断 if 

else 逻辑 判断 ， 结 合 站 使 用 

while while 循环 

do do 循环 

when 条 件 判 断 

interface 接口 声明 

file 文件 

field 成 员 

property 属性 

receiver 接收 者 

param 参数 

setparam 设置 参数 

delegate 委托 

import 导入 包 

where where 条 件 

by 委托 类 或 属性 

get get 函数 

set set 函数 

constructor 构造 函数 

init 初始 化 代码 块 

try 异常 捕获 

catch 异常 捕获 ， 结 合 try 使 用 

finally 异常 最 终 执行 代码 块 

dynamic 动态 的 


typeof 类 型 定义 ， 预 留用 


这 些 关 键 字 定义 在 源码 org.jetbrains.kotlin.lexer.KtTokens.java 中 。 
2.3 流程 控制 语句 


流程 控制 语句 是 编程 语言 中 的 核心 之 一 ， 可 分 为 : 
口 分 支 语句 (if、when) 

O 循环 语句 (for、while) 

口 跳 转 语 句 (retum、break、continue、throw) 


DEIER 
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2.3.1 if RER 


f…else 语句 是 控制 程序 流程 的 最 基本 形式 ,其 中 else 是 可 选 的 。 在 Kotlin 中 , 让 是 一 
个 表达 式 ， 即 它 会 返回 一 个 值 ( 跟 Scala 一 样 ) 。 代 码 示例 如 下 : 


package com.easy.kotlin 


fun main(args: Array<String>) { 


println (max (1, 2)) // 调 用 max() 函数 
} 
fun max(a: Int, b: Int): Int { // 声 明 max () 函数 
// 表 达 式 返 回 值 


val max = if (a > b) a else b  // 直 接 使 用 if…else 表达 式 来 实现 max 逻辑 
return max 


} 
另外 ，if 的 分 支 可 以 是 代码 块 ， 最 后 的 表达 式 作为 该 块 的 值 : 


fun max3(a: Int, b: Int): Int { 
val max = if (a > b) { // 这 里 {} 中 的 内 容 是 一 个 代码 块 


print ("Max is a") 


a // 最 后 的 表达 式 作为 该 代码 块 的 值 
} else { 

print ("Max is b") 

b // 同 上 


return max 


} 

让 作为 代码 块 时 ， 最 后 一 行为 其 返回 值 。 另 外 ， 在 Kotlin 中 没有 类 似 true? 1:0 这 样 的 
三 元 表达 式 。 对 应 的 写法 是 使 用 if-else 语句 : 

if(true) 1 else 0 //if*…else 实现 三 元 表达 式 的 逻辑 

if-else 语句 规则 : 让 后 的 括号 不 能 省 略 ， 括 号 里 表达 式 的 值 必须 是 布尔 型 。 

代码 反例 : 


>>> if("a") 1 //if 中 只 能 是 布尔 类 型 的 值 ， 此 处 是 字符 串 "a"， 报 错 
error: type mismatch: inferred type is String but Boolean was expected 
Es dat- lard R S 


A 


>>> if(1) print1n(1) //if 中 传 入 Int 类 型 ， 报 错 
error: the integer literal does not conform to the expected type Boolean 
if (1) 


如 果 条 件 体内 只 有 一 条 语句 需要 执行 ， 那 么 让 后 面 的 大 括号 可 以 省 略 。 良 好 的 编程 风 


格 是 建议 加 上 大 括号 。 


>>> if(true) println(1) else println(0) //if 后 面 的 大 括号 可 以 省 略 
1 
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>>> if(true) { println(1)} else{ println(0)}// 良 好 的 编程 风格 是 建议 加 上 大 括号 
1 


编程 实例 : 用 ift-else HJARREN EE EAS. 


fun isLeapYear (year: Int): Boolean { 


var isLeapYear: Boolean // 声 明 一 个 局 部 变量 
if ((year % 4 == 0 && year % 100 != 0) II (year % 400 == 0)) { 
// PUB KGR 


isLeapYear = true 
} else { 

isLeapYear = false 
} 
return isLeapYear 


fun main(args: Array<String>) { 
printin(isLeapYear (2017) ) // 不 是 半年 
printin(isLeapYear (2020) ) // Fe 


2.3.2 when 表达 式 


when 表达 式 类 似 于 switch…case RIAL. when 会 对 所 有 的 分 支 进行 检查 直到 有 一 个 
条 件 被 满足 。 但 相 比 switch 而 言 ，when 语句 的 功能 要 更 加 强大 、 灵 活 。 
Kotlin 的 极 简 语 法 表达 风格 ， 使 得 我 们 对 分 支 检查 的 代码 写 起 来 更 加 简单 、 直 接 : 


fun casesWhen(obj: Any?) { 


when (obj) { //when 表达 式 
0,1,2,3,4,5,6,7,8,9 -> print1n("${obj} ===> 这 是 一 个 0-9 之 间 的 数字 ") 
// 逗 号 分 隔 的 序列 


"hello" -> println("${obj} ===> 这 个 是 字符 串 hello") // 字 符 串 

is Char -> println("${obj} ===> 这 是 一 个 Char 类 型 数据 ") //is 类 型 判断 
else -> println("${obj} ===> else 类 似 于 Java 中 的 case-switch 中 的 
default") // 默 认 路 径 


} 


fun main(args: Array<String>) { 
casesWhen (1) 
casesWhen ("hello") 
casesWhen ('X') 
casesWhen (null) 


} 


输出 如 下 : 


1 ===> 这 是 一 个 0-9 之 间 的 数字 

hello ===> 这 个 是 字符 串 hello 

X ===> 这 是 一 个 Char 类 型 数据 

null ===> else 类 似 于 Java 中 的 case-switch 中 的 default 

if 语句 一 样 ，when 语句 的 每 一 个 分 支 也 可 以 是 一 个 代码 块 ， 它 的 值 是 块 中 最 后 的 
表达 式 的 值 。 如 果 其 他 分 支 都 不 满足 条 件 会 到 else XK (BY default) - 
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如 果 我 们 有 很 多 分 支 需要 用 相同 的 处 理 方式 ， 则 可 以 把 多 个 分 支 条 件 放 在 一 起 ， 用 去 
号 分 隔 : 
0,1,2,3,4,5,6,7,8,9 > println("${obj} ==> 这 是 一 个 0 9 之 间 的 数字 ") 


可 以 用 任意 表达 式 〈 而 不 只 是 常量 ) 作为 分 支 条 件 : 


fun switch(x: Int) { 

val s = "123" 

when (x) { 
-1, 0 -> print("x == -1 or x == 0") 
1 -> print ("x == 1") 
2 -> print ("x == 2") 
8) -> print ("x is 8") 
parseInt(s) -> println("x is 123") 
else -> { // 注 意 这 个 块 

print("x is neither 1 nor 2") 


} 
} 
也 可 以 检测 一 个 值 在 in 或 者 不 在 !in 一 个 区 间或 者 集合 中 : 


valx=1 

val validNumbers = arrayOf(1, 2, 3) 

when (x) { 
in 1..10 -> print("x is in the range") // 是 否 在 范围 1. (o 
in validNumbers -> print ("x is valid") // 是 否 在 数据 arrayof (1，2，3) 中 
lin 10..20 -> print("x is outside the range")  // 不 在 范围 10. .20 中 
else -> print("none of the above") // 默 认 路 径 

} 


编程 实例 : 用 when 语句 写 一 个 阶乘 函数 。 


fon tactin: Int): Int { 
var result = 1 
when (n) { 
0, 1 -> result = 1 // 当 n=0,1 的 时 候 ， 返 回 1 
else -> result = n * fact (n - 1) // 除 了 0,1 两 种 情况 ， 递 归 调用 自己 n * fact (n-1) 


} 
return result 


} 
fact (10) //3628800 


2.3.3 for 循环 


for 循环 可 以 对 任何 提供 迭代 器 (iterator) 的 对 象 进行 遍历 ， 语 法 如 下 : 
for (item in collection) { //for in 循环 
print (item) 


} 


如 果 想 要 通过 索引 遍历 一 个 数组 或 者 一 个 list， 可 以 这 么 做 : 
for (i in array.indices) { //array.indices 存储 了 数组 array 的 下 标 序列 
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print (array[i]) 
i 
其 中 ,array.indices 持 有 数组 的 下 标 列 表 。 我 们 也 可 以 使 用 函数 withIndex() 来 遍历 下 标 
与 对 应 的 元 素 : 
for ((index, value) in array.withIndex()) { // 带 下 标 index 来 访问 数据 


println("the element at $index is $value") 


} 


另外 ， 范 围 (Ranges) 表达 式 也 可 用 于 循环 中 : 


for(i nel lO) / (SNF 1 <= i se i <= 10 
println (i) 

D 

代码 简写 如 下 : 


(1..10).forEach { print(it) } 


其 中 的 操作 符 形式 的 1..10 等 价 于 1.rangeTo(10) 函数 调用 ， 由 in 和 !in 进行 连接 。 
编程 实例 : 编写 一 个 Kotlin 程序 在 屏幕 上 输出 1! +2! 43! +…+10! 的 和 。 
我 们 使 用 上 面 的 factO 函 数 ， 代 码 实 现 如 下 : 
fun sumFact(n: Int): Int { // 函 数 声明 

var sum = 0 

for (a in doanh A //for in 循环 

sum += fact(i) //sum 累加 fact (i) 的 值 
} 


return sum 


} 


sumFact (10) //4037913 


2.3.4 while 循环 


while 和 do…while 循环 语句 的 使 用 方式 与 C、Java 语言 基本 一 致 。 代 码 示例 如 下 : 


package com.easy.kotlin 


fun main(args: Array<String>) { 
var x = 10 


while (x > 0) { //4 x KF 0 
x 
println (x) 

} 

var y = 10 

do { // 执 行 do 
二 
println(y) 


} while (y < 20) //while 判断 条 件 ，Yy 的 作用 域 包含 此 处 
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2.3.5 break 和 continue 


break 和 continue 语句 都 是 用 来 控制 循环 结构 的 ， 主 要 用 来 停止 循环 〈 中 断 跳 转 )， 但 
是 二 者 又 有 区 别 ， 下 面 分 别 介绍 。 
break 语句 用 于 完全 结束 一 个 循环 ， 直 接 跳出 循环 体 ， 然 后 执行 循环 后 面 的 语句 。 


1. 问题 场景 : 打印 数字 1 一 10， 只 要 遇 到 偶数 就 结束 打印 


下 面 我 们 使 用 for 循环 打印 1 一 10 之 间 的 数字 ， 遇 到 偶数 就 使 用 break 语句 结束 循环 。 
代码 示例 如 下 : 


for G am elon //for in 循环 
println (i) 
if (i % 2 == 0) { 
break // 直 接 跳 出 整个 for 循环 体 
} 
} //break to here 
输出 如 下 : 


T 
2 


continue 语句 是 只 终止 本 轮 循环 ， 但 是 还 会 继续 下 一 轮 循环 。 可 以 简单 理解 为 直接 在 
当前 语句 处 中 断 ， 跳 转 到 循环 入 口 ， 执 行 下 一 轮 循环 。 而 break 语句 则 是 完全 终止 循环 ， 
跳 转 到 循环 出 口 。 

2. 问题 场景 : 打印 数字 1 一 10 中 的 奇数 


下 面 我 们 使 用 for 循环 来 打印 1 一 10 中 的 数字 ， 遇 到 偶数 就 使 用 continue 语句 跳 过 本 
轮 循 环 ， 实 现 只 打印 奇数 的 效果 。 代 码 示例 如 下 : 


for (Gb abet ales) oi 
if (i % 2 == 0) { 
continue // 执 行 下 一 个 i 的 值 ， 继 续 for 循环 
} 
println (i) 
} 


输出 如 下 : 


2.3.6 return 返回 


在 Java 和 C 语言 中 ，retum 语句 是 很 常见 的 了 。 虽 然 在 Scala 和 Groovy 类 语言 中 ， 函 
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数 的 返回 值 可 以 不 需要 显示 用 retum 语句 来 指定 ， 但 是 我 们 仍然 认为 使 用 retum 语句 的 编 
码 风 格 更 容易 阅读 理解 〈 尤 其 是 在 分 支流 代码 块 中 ) 。 

在 Kotlin F, 除了 表达 式 的 值 , 有 返回 值 的 函数 都 要 求 显 式 使 用 retum 语句 返回 其 值 。 
代码 示例 如 下 : 


fun sum(a: Int,b: Int): Int{ 
return atb // 这 里 的 return 不 能 省 略 


fun maxta: Imt, be Int): Ine { 


if (a > bhi 

return a //return 不 能 省 略 
} else{ 

return b //return 不 能 省 略 


} 


在 Kotlin 中 可 以 直接 使 用 “=” 符 号 返回 一 个 函数 的 值 ， 这 样 的 函数 称 为 函数 字面 量 。 
代码 示例 如 下 : 


>>> fun sum(a: Int,b: Int) =a +b Vey) 
>>> fun mariar int, De Int) = if (a > p) alellsembi/i/1(2) 
>>> sum(1,10) 

dat 

>>> max (1,2) 

2 


代码 说 明 如 下 : 
第 (1) 处 使 用 表达 式 声明 sum0) 函 数 。 
第 (2) 处 ifelse 表达 式 返 回 的 是 一 个 值 ， 我 们 直接 用 表达 式 来 定义 一 个 max() 函 数 。 


>>> val sum=fun(a:Int, b:Int) = atb // (3) 
>>> sum 

(kotlin.Int, kotlin.Int) -> kotlin.Int 

>>> sum(1,1) 

2 


第 G) 处 使 用 fun 关键 字 声 明了 一 个 匿名 函数 ， 并 且 直 接 使 用 表达 式 来 实现 函数 。 需 
要 注意 的 是 , 后 面 的 函数 体 语句 中 有 没有 大 括号 代表 的 意义 完全 不 同 。 例如 下 面 的 代码 : 


>>> val sumf = fun(a:Int, b:Int) = {a+b} // (4) 直接 使 用 表达 式 声 明 函 数 
>>> sumf 

(kotlin.Int, kotlin.Int) -> () -> kotlin.Int //(5) sumf 是 一 个 高 阶 函数 类 型 
>>> sumf (1,1) // (6) // 调 用 sumf (1,1)， 返 回 的 是 一 个 函数 

() -> kotlin.Int //(7) 

>>> sumf (1,1) .invoke() //(8) // 使 用 invoke 调用 函数 

E 

>>> sumf (1,1) () //(9) 使 用 括号 () 调用 函数 ， 跟 invoke () 函数 调用 等 价 
2 

代码 说 明 如 下 : 


第 (4) 处 带 上 大 括号 人 0 的 表达 式 返 回 的 是 一 个 Lambda 表达 式 。 
第 (5) 处 {atb} 的 类 型 是 从 (kotlin.Int, kotlin.Inb 到 0->kotlin.Int 的 映射 函数 。 
第 (6) 处 调用 了 sumfO 函 数 。 
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第 〈7) 处 中 sumf(1,1) 的 返回 值 是 一 个 函数 ()->kotlinInt， 而 不 是 具体 的 数值 2。 如 何 
实现 真正 的 函数 调用 呢 ? 请 看 第 (8) 处 。 

第 (8) 处 使 用 invoke0 函 数 实现 真正 调用 函数 。 

在 Kotlin 中 ，0 操 作 符 对 应 的 是 类 的 重 载 函数 ， 如 invoke()。 我 们 使 用 0 运算 符 来 调用 
函数 。 也 就 是 说 第 (8) 处 与 第 O) 处 是 等 价 的 写法 。 

我 们 也 可 以 使 用 fun 关键 字 加 上 函数 名 来 声明 函数 ， 下 面 同样 是 展示 带 上 大 括号 他 的 
例子 ， 代 码 示例 如 下 : 


>>> fun sumf (a:Int,b:Int) = {a+b} // 直 接 使 用 表达 式 声 明 函 数 ， 注 意 到 这 里 的 {} 表 示 


一 个 Lambda 
>>> sumf (1,1) // 返 回 类 型 是 一 个 函数 () -> kotlin.Int 
() -> kotlin.Int 
>>> sumf (1,1) .invoke() // 使 用 invoke 调用 函数 
2 
>>> fun maxf(a:Int, b:Int) = {if(a>b) a else b} 
>>> maxf (1,2) // 跟 上 面 的 sumf () 函数 类 似 , 这 里 的 返回 类 型 也 是 一 个 函数 
() -> kotlin.Int 
>>> maxf (1,2) .invoke() // 使 用 invoke () 函数 调用 maxf (1, 2) 函数 
2 


可 以 看 出 ，sumf 和 maxfO) 的 返回 值 都 是 函数 类 型 ; 


() -> kotlin.Int 


这 点 与 Scala 是 不 同 的 。 在 Scala 中 ， 带 不 带 大 括号 {} 的 意义 是 一 样 的 : 


scala> def maxf(x:Int, y:Int) = { if(x>y) x else y } 


//scala 的 函数 表达 式 带 {} ， 返 回 类 型 依然 是 Int 
maxf: (xs Int, y: int)int 


scala> def maxv(x:Int, y:Int) = if(x>y) x else y 


//scala 不 带 {} 与 上 面 带 {} 的 语法 等 价 
maxv: (x: Int, y: Int)Int 


scala> maxf (1,2) // 直 接 调用 maxf (1,2) 函数 ， 返 回 值 是 一 个 Int 
res4: Int = 2 


scala> maxv (1,2) // 同 上 

res6: Int = 2 

可 以 看 出 ，maxf: (x: Int.y:Int)Int 与 maxv: (x: Int, y: Int)Int 的 签名 是 一 样 的 。 在 这 里 ， 
Kotlin 与 Scala 在 大 括号 的 使 用 上 是 完全 不 同 的 。 调 用 函数 方式 是 直接 调用 invoke() BM 
sumf(1,1).invoke(). 

Kotlin 中 retum 语句 会 从 最 近 的 函数 或 匿名 函数 中 返回 ,但 是 在 Lambda 表达 式 中 遇 到 
retum 语句 时 ， 则 直接 返回 最 近 的 外 层 函 数 。 例 如 下 面 两 个 函数 是 不 同 的 : 


val intArray = intArrayOf(1, 2, 3, 4, 5) // 声 明 一 个 Int 数组 
intArray.forEach { 
if (it == 3) return //# Lambda 表达 式 中 的 return 直接 返回 最 近 的 外 层 函 数 
println (it) 
} 


输出 如 下 : 
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al 

2 

遇 到 3 时 会 直接 返回 〈 类 似 于 循环 体 中 的 break 语句 ) 。 

而 我 们 给 forEach 传 入 一 个 匿名 函数 fun(a:Inb， 这 个 匿名 函数 里 的 retum 语句 不 会 跳 
出 forEach 循环 ， 有 点 像 continue 语句 的 效果 : 


val intArray = intArrayOf(1, 2, 3, 4, 5) 
intArray.forEach(fun(a: Int) { // 这 是 一 个 匿名 函数 
if (a == 3) return // 从 最 近 的 函数 中 返回 ， 也 就 是 上 面 的 匿名 函数 fun (a:Int), 但 
是 循环 会 继续 
println(a) 


输出 如 下 : 


2 

4 

5 

为 了 显 式 地 指明 retum 语句 返回 的 地 址 ，Kotlin 还 提供 了 @Label (标签 ) 来 控制 返回 
语句 ， 且 看 2.3.7 节 的 讲解 。 
2.3.7 标签 (label) 


在 Kotlin 中 任何 表达 式 都 可 以 用 标签 (label) 来 标记 。 标 签 的 格式 为 标识 符 后 跟 @ 符 
号 ,如 abc@、isOK@ 都 是 有 效 的 标签 。 我 们 可 以 用 Label 标 签 来 控制 retum break EÈ continue 
语句 的 跳 转 Gump) 行为 。 


代码 示例 如 下 : 
val intArray = intArrayOf(1, 2, 3, 4, 5) 
intArray.forEach here@ { //here@ 是 一 个 标签 


if (it == 3) return@here // 执 行 指令 跳 转 到 Lambda 表达 式 标签 here@ 处 。 继 续 
下 一 个 让 =4 的 遍历 循环 
println(it) 


输出 如 下 : 


an 心情 


我 们 在 Lambda 表达 式 开头 处 添加 了 标签 here@， 可 以 这 么 理解 : 该 标签 相当 于 记录 
T Lambda 表达 式 的 指令 执行 入 口 地 址 ,然后 在 表达 式 内 部 使 用 return@here 跳 转 至 Lambda 
表达 式 中 的 该 地 址 处 。 这 样 代码 更 加 易 懂 。 

另外 ， 也 可 以 使 用 隐 式 标签 ， 更 加 方便 。 该 标签 与 接收 该 Lambda 的 函数 同名 。 

代码 示例 如 下 : 


val intArray = intArrayOf(1, 2, 3, 4, 5) 
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intArray.forEach { 
if (it == 3) return@forEach // 返 回 aforEach 处 继续 下 一 个 循环 


println (it) 
} 
输出 如 下 : 
al 
2 
4 
5 


接收 该 Lambda 表达 式 的 函数 是 forEach, 所 以 我 们 可 以 直接 使 用 return@forEach 跳 转 
到 此 处 执行 下 一 轮 循环 。 


2.3.8 throw 表达 式 


在 Kotlin 中 throw 是 表达 式 , 它 的 类 型 是 特殊 类 型 Nothing。 该 类 型 没有 值 , 与 C、Java 
语言 中 的 void 意思 一 样 。 


>>> Nothing::class // 使 用 : :类 引用 操作 符 ， 返 回 这 个 Nothing 类 的 类 型 
class java.lang.Void //Nothing 直接 映射 到 Java 中 的 Void 类 型 


我 们 在 代码 中 ， 用 Nothing 来 标记 无 返回 的 函数 : 


>>> fun fail(msg:String) :Nothing{ throw IllegalArgumentException(msg) } 
// 返 回 类 型 Nothing， 表 示 该 函数 永远 不 会 返回 某 个 值 了 
>>> fail ("XXXX") // 调 用 fail () 函数 ， 将 会 直接 抛 出 异常 
java.lang.IllegalArgumentException: XXXX 
at Line57.fail (Unknown Source) 


另外 ， 如 果 把 一 个 throw 表达 式 的 值 赋 给 一 个 变量 ,需要 显 式 声明 类 型 为 Nothing， 代 
码 示例 如 下 : 
>>> val ex = throw Exception("YYYYYYYY") //ex 需要 显 式 声 明 类 型 为 Nothing， 
否则 报错 


error: 'Nothing' property type needs to be specified explicitly 
val ex = throw Exception ("YYYYYYYY") 


>>> val ex:Nothing = throw Exception ("YYYYYYYY") 


// 显 式 声明 ex 的 类 型 为 Nothing 
java.lang.Exception: YYYYYYYY 


另外 ， 因 为 ex 变量 是 Nothing 类 型 ， 没 有 任何 值 ， 所 以 无 法 作为 参数 传 给 函数 。 
2.4 操作 符 与 重 载 


Kotlin 允许 我 们 为 自己 的 类 型 提供 预定 义 的 一 组 操作 符 的 实现 。 这 些 操作 符 具 有 固定 
的 符号 表示 (如 “+” 或 “*”) 和 固定 的 优先 级 。 这 些 操作 符 的 符号 定义 如 下 : 


KtSingleValueToken LBRACKET = new KtSingleValueToken ("LBRACKET", "["); 
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KtSingleValueToken RBRACKET = new KtSingleValueToken ("RBRACKET", "]"); 
KtSingleValueToken LBRACE = new KtSingleValueToken("LBRACE", "{"); 
KtSingleValueToken RBRACE = new KtSingleValueToken ("RBRACE", "}"); 
KtSingleValueToken LPAR = new KtSingleValueToken("LPAR", "("); 
KtSingleValueToken RPAR = new KtSingleValueToken("RPAR", ")"); 
KtSingleValueToken DOT = new KtSingleValueToken("DOT", "."); 
KtSingleValueToken PLUSPLUS = new KtSingleValueToken ("PLUSPLUS", "++"); 


KtSingleValueToken MINUSMINUS = new KtSingleValueToken ("MINUSMINUS", 


mim); 


KtSingleValueToken MUL = new KtSingleValueToken("MUL", "*"); 
KtSingleValueToken PLUS = new KtSingleValueToken("PLUS", "+"); 
KtSingleValueToken MINUS = new KtSingleValueToken("MINUS", "-"); 
KtSingleValueToken EXCL = new KtSingleValueToken("EXCL", "!"); 
KtSingleValueToken DIV = new KtSingleValueToken("DIV", "/"); 
KtSingleValueToken PERC = new KtSingleValueToken("PERC", "%3"); 
KtSingleValueToken LT = new KtSingleValueToken("LT", "<"); 
KtSingleValueToken GT = new KtSingleValueToken ("GT", d 
KtSingleValueToken LTEQ = new KtSingleValueToken ("LTEQ", "<="); 
KtSingleValueToken GTEQ = new KtSingleValueToken ("GTEQ", "> 
KtSingleValueToken EQEQEQ = new KtSingleValueToken ("EQEQEQ", 
KtSingleValueToken ARROW = new KtSingleValueToken ("ARROW", "->"); 
KtSingleValueToken DOUBLE ARROW = new KtSingleValueToken ("DOUBLE ARROW", 
"=>"); 


KtSingleValueToken EXCLEQEQEQ = new KtSingleValueToken ("EXCLEQEQEQ", 


="); 


KtSingleValueToken EQEQ = new KtSingleValueToken ("EQEQ", "=="); 
KtSingleValueToken EXCLEQ = new KtSingleValueToken ("EXCLEQ", " 
KtSingleValueToken EXCLEXCL = new KtSingleValueToken ("EXCLEXCL", 
KtSingleValueToken ANDAND = new KtSingleValueToken ("ANDAND", "&&"); 
KtSingleValueToken OROR = new KtSingleValueToken ("OROR", "|1"); 


KtSingleValueToken SAFE ACCESS = new KtSingleValueToken ("SAFE ACCESS", " 
Sol 


KtSingleValueToken ELVIS = new KtSingleValueToken("ELVIS", "?:"); 
KtSingleValueToken QUEST = new KtSingleValueToken("QUEST", "?"); 
KtSingleValueToken COLONCOLON = new KtSingleValueToken ("COLONCOLON", "::"); 
KtSingleValueToken COLON = new KtSingleValueToken("COLON", ":"); 
KtSingleValueToken SEMICOLON = new KtSingleValueToken("SEMICOLON", "; 
KtSingleValueToken DOUBLE SEMICOLON = new KtSingleValueToken ("DOUBLE 
SEMICOLON", ";;"); 
KtSingleValueToken RANGE = new KtSingleValueToken("RANGE", ".."); 
KtSingleValueToken EQ = new KtSingleValueToken("EQ", "="); 
KtSingleValueToken MULTEQ = new KtSingleValueToken ("MULTEQ", "*="); 
KtSingleValueToken DIVEQ = new KtSingleValueToken ("DIVEQ", "/="); 
KtSingleValueToken PERCEQ = new KtSingleValueToken ("PERCEQ", We 
KtSingleValueToken PLUSEQ = new KtSingleValueToken ("PLUSEQ", " ); 
KtSingleValueToken MINUSEQ = new KtSingleValueToken ("MINUSEQ", " As 
KtKeywordToken NOT IN = KtKeywordToken.keyword("NOT IN", “"!in"); 
KtKeywordToken NOT IS = KtKeywordToken.keyword("NOT IS", "!is"); 
KtSingleValueToken HASH = new KtSingleValueToken("HASH", "#"); 
KtSingleValueToken AT = new KtSingleValueToken("AT", "@"); 
KtSingleValueToken COMMA = new KtSingleValueToken ("COMMA", ","); 


2.4.1 操作 符 优先 级 


Kotlin 中 操作 符 的 优先 级 (Precedence) 如 表 2-10 所 示 。 
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表 2-10 操作 符 的 优先 级 

th 先 级 P 题 符 ”号 
最 高 JAR (Postfix) H, —, „11,2? 
前 级 (Prefix) -, +, +, —, !, labelDefinition@ 
右手 类 型 运算 (Type RHS, 
right-hand side class type 1, aS, as? 
(RHS) ) 
乘除 取 余 (Multiplicative) DACH 
Im (Additive ) 十 ,一 
区 间 范 围 Range) e 
《优先 级 往 下 eg 例如 ,给 Int 定 义 扩展 infix fun Int.shl(x: Int): Int {...}, 
TRUK x 函数 这 样 调用 1 shl 2， 等 同 于 1.shl(2) 


Elvis 操作 符 Lë 
命名 检查 符 (Named checks) | in, tin, is, lis 
比较 大 小 (Comparison ) <, >, <=, >= 
相等 性 判断 (Equality) = l =, |= 
45 (Conjunction) && 
BK (Disjunction ) \N 
最 低 JA (Assignment) =, +5, We /=, %= 


为 实现 这 些 操作 符 ，Kotlin 为 二 元 操作 符 左 侧 的 类 型 和 一 元 操作 符 的 参数 类 型 提供 了 
相应 的 函数 或 扩展 函数 。 重 载 操作 符 的 函数 需要 用 operator 修饰 符 标 记 ， 中 绥 操 作 符 函数 
使 用 infix 修饰 符 标记 。 


2.4.2 一 元 操作 符 
一 元 操作 符 (unary operation) 有 前 缀 操作 符 、 递 增 和 递减 操作 符 等 。 
1. 前 缀 操作 符 


前 缀 操作 符 放 在 操作 数 的 前 面 ， 分 别 如 表 2-11 所 示 。 
表 2-11 前 缀 操作 符 


RAR SS 为 
+a a.unaryPlus() 
ki a.unaryMinus() 
la a.not() 
以 下 是 重 载 一 元 减 运算 符 的 示例 : 
package com.easy.kotlin 
data class Point(val x: Int, val y: Int) // (1) 声明 数据 类 Point 


operator fun Point.unaryMinus() = Point(-x, -y) // (2) operator 修饰 符 修 
饰 一 个 重 载 操 作 符 函 数 
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代码 说 明 如 下 : 

第 (1) 处 声明 Point 数据 类 。 

第 (2) 处 使 用 operator 关键 字 实现 重 载 函 数 unaryMinus()。 
测试 代码 如 下 : 

package com.easy.kotlin 

import org.junit.Test 


import org.junit.runner.RunWith 
import org.junit.runners.JUnit4 


@RunWith (JUnit4::class) 
class OperatorDemoTest { 


@Test 
fun testPointUnaryMinus() { 
val p = Point(1, 1) 
val np = -p // 直 接 使 用 unaryMinus () 重 载 函数 操作 符 "-" 
println (np) //Point (x=-1, y=-1) 
} 
} 


2. 递增 和 递减 操作 符 


incO0 和 dec0 函 数 必须 返回 一 个 值 , 它 用 于 赋值 给 使 用 + 或 -- 操 作 的 变量 。 前 级 和 后 级 
的 表达 式 的 返回 值 是 不 同 的 ， 具 体 的 取 值 如 表 2-12 所 示 。 


表 2-12 ”递增 和 递减 操作 符 


表 达 式 SS 为 
att ainc0 返 回 值 是 a 
a— a.dec0 返 回 值 是 a 
+a a.inc0 返 回 值 是 a+1 
—a a.dec0 返 回 值 是 a-1 


2.4.3 ”二 元 操作 符 


Kotlin 中 的 二 元 操作 符 有 算术 运算 符 、 索 引 访问 操作 符 、 调 用 操作 符 、 计 算 并 赋值 操 
作 符 、 相 等 与 不 等 操作 符 、Elvis 操作 符 、 比 较 操 作 符 、 中 组 操作 符 等 。 下 面 我 们 分 别 介绍 。 
1. 算术 运算 符 


Kotlin 的 算术 运算 符 有 加 、 减 、 乘 、 除 、 取 余 、 范 围 操 作 符 等 ， 如 表 2-13 所 示 。 


#213 算术 运算 符 
ZS 达 式 翻 译 为 
a+b a.plus(b) 
a-b a.minus(b) 
a*b | a.times(b) 


a/b a.div(b) 
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续 表 


ZS i 式 a 译 为 


a%b 


a.rem(b), a.mod(b) 


代码 示例 如 下 : 


>>> 
>>> 
>>> 
13 
>>> 
7 
>>> 
3 
>>> 
1 
>>> 
10. 
>>> 


a..b 


val a=10 
val b=3 
atb 


// 加 法 操作 符 
// 减 法 操作 符 
// 除 法 操作 符 
// 取 余 操作 符 
// 范 围 操 作 符 
// 范 围 操 作 符 


a.rangeTo(b) 


简单 的 四 则 运算 操作 符 这 里 就 不 多 说 了 。 需要 注意 的 是 范围 运算 符 a.b 与 b..a 的 区 别 。 
2. 字符 串 的 “+” 运 算 符 重 载 


先 用 代码 举 个 例子 : 
//String 类 型 重 载 了 加 法 操作 符 


>>> 
1 
>>> 


public final operator 
public final operator 
public final operator 
public final operator 


vrai 


yee" 


dae 


A 


//Int 类 型 没有 重 载 操作 符 plus (other:String) 

error: none of the following functions can be called with the arguments supplied: 
public final operator fun plus(other: Byte): Int defined in kotlin.Int 
public final operator fun plus (other: Double) : Double defined in kotlin.Int 


fun plus(other: Float): Float defined in kotlin.Int 
fun plus(other: Int): Int defined in kotlin.Int 

fun plus(other: Long): Long defined in kotlin.Int 
fun plus(other: Short): Int defined in kotlin.Int 


从 上 面 的 示例 可 以 看 出 ,在 Kotlin 中 1+"" 是 不 允许 的 ( 相 比 Scala 语言 , 写 这 样 的 Kotlin 
代码 显得 不 太 友 好 ) ， 只 能 显 式 调用 toString) KHR: 


>>> toString ESA 


3. 自 定 义 重 载 的 “+” 运 算 符 


// 先 把 Int 类 型 的 1 转换 成 String BAM 1 


下 面 使 用 一 个 计数 类 Counter 重 载 的 “+ ”运算 符 来 增加 index 的 计数 值 。 代 码 示 例如 下 : 


data class Counter(var index: 


Int) // 声 明 一 个 计数 类 


operator fun Counter.plus(increment: Int): Counter { // BR “+” 运算 符 
return Counter (index + increment) // 计 数 器 的 实现 :index 加 上 increment 


j; 
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测试 类 如 下 : 


package com.easy.kotlin 


import org.junit.Test 
import org.junit.runner.RunWith 
import org.junit.runners.JUnit4 
@RunWith (JUnit4::class) 
class OperatorDemoTest 
@Test 
fun testCounterIndexPlus() { 
val c = Counter(1)  // 声 明 一 个 Counter 对 象 ， 初 始 化 index = 1 
val cplus = c + 10 // 调 用 重 载 的 加 法 运算 符 
println(cplus) // 返 回 Counter (index=11) 


} 

4. in 操作 符 

in 操作 符 等 价 于 contains0 函 数 ， 如 表 2-14 所 示 。 
表 2-14 in 操作 符 


表 达 HX 翻 译 为 
ainb b.contains(a) 
alinb 'b.contains(a) 


5. 索引 访问 操作 符 


索引 访问 操作 符 方 括号 [] 转 换 为 调用 带 有 适当 数量 参数 的 get 和 set， 如 表 2-15 所 示 。 
表 2-15 索引 访问 操作 符 


表 达 式 SS 为 
ali] a.get(i) 
a{i]=b aset), b) 
6. 调用 操作 符 


小 括号 调用 符 () 转 换 为 调用 invoke0O 函 数 ,， 同 样 带 参数 调用 也 会 转换 为 invoke0 函 数 中 
的 参数 。 具 体 的 调用 示例 如 表 2-16 所 示 。 


表 2-16 调用 操作 符 


ZS 达 HX 翻 译 为 
a) a.invoke() 
a(i) a.invoke(i) 


7. 计算 并 赋值 操作 符 


对 于 赋值 操作 , 例如 at—b, 编译 器 会 试 着 生成 a=atb 的 代码 (这 里 包含 类 型 检查 : atb 
的 类 型 必须 是 a 的 子 类 型 ) 。 计 算 并 赋值 操作 符 对 应 的 重 载 函数 如 表 2-17 所 示 。 
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表 2-17 计算 并 赋值 操作 符 


at=b a.plusAssign(b) 

a 一 b a.minusAssign(b) 
a*=b a.timesAssign(b) 
a/=b a.divAssign(b) 
a%=b a.modAssign(b) 


8. 相等 与 不 等 操作 符 
Kotlin 中 有 两 种 类 型 的 相等 性 : 


口 结构 相等 一 != (使 用 equals0 判 断 〉。 


表 2-18 相等 与 不 等 操作 符 
表达 式 a 译 为 
a?.equals(b) ?: (b == null) 
!(a?.equals(b) ?: (b == null)) 


“一 ”操作 符 有 些 特殊 : 它 被 翻译 成 一 个 复杂 的 表达 式 ， 用 于 筛选 null 值 。 意 思 是 : 
如 果 a 不 是 null 则 调用 equals(Any?) 函 数 并 返回 其 值 ; 否则 ( 即 a 一 =null) 就 计算 b=== null 
的 值 并 返回 。 

当 与 null 显 式 比较 时 ，a==null 会 被 自动 转换 为 anull. 


Die, 一 -和 ! 一 不 可 重 载 


9. Elvis 操 作 符 ?: 
在 Kotin 中 ，Elvis 操作 符 特 定 是 跟 null 进行 比较 。 也 就 是 说 


y = x?:0 // 使 用 Elvis 操作 符 ? : 
等 价 于 

val y = if(x!==null) x else 0 // 等 价 的 if…else 逻辑 
主要 用 来 作 null 安全 性 检查 。 


Elvis 操作 符 “?:” 是 一 个 二 元 运算 符 ， 如 果 第 一 个 操作 数 为 真 ， 则 返回 第 一 个 操作 数 ， 
否则 将 计算 并 返回 其 第 二 个 操作 数 。 它 是 三 元 条 件 运 算 符 的 变 体 ， 命 名 灵感 来 自 猫 王 的 发 
型 风格 。 

Kotlin 中 没有 这 样 的 三 元 运算 符 true?1:0, 取而代之 的 是 if(true) 1 else 0。 而 Elvis 操作 
符 算 是 精简 版 的 三 元 运算 符 。 

我 们 在 Java 中 使 用 的 三 元 运算 符 的 语法 通常 要 重复 变量 两 次 ， 示 例如 下 : 

String name = "Elvis Presley"; 

String displayName = (name != null)? name: "Unknown"; //Java 中 的 三 元 操作 符 
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可 以 使 用 Elvis 操作 符 取而代之 : 


String name = "Elvis Presley"; 
String displayName = name?:"Unknown" // 使 用 Elvis 操作 符 


可 以 看 出 ， 用 Elvis 操作 符 “?:” 可 以 把 带 有 默认 值 的 过 …else 结构 写 得 极其 简短 。 用 


Elvis 操作 符 不 用 检查 null (避免 了 NullPointerException) ， 也 不 用 重复 变量 。 


Elvis 操作 符 的 这 个 功能 在 Spring KARHE (SPEL) 中 有 提供 ， 在 Kotlin 中 当然 没 


有 理由 不 支持 这 个 特性 了 。 

代码 示例 如 下 : 

>>> val x = null 

>>> val y = x?:0 // 等 价 的 逻辑 是 : if(x!==null) x else 0， 此 处 x===null, MU 
选择 else 分 支 ， 返 回 0 

>>> y 

0 

>>> val x = false 

>>> val y = x?:0 //x 是 false， 这 个 时 候 x!==nul1， 所 以 返回 值 就 是 x AA false 

>>> y 

false 

29> .| We = A 

>>> val y = x?:0 //x!==null, 返回 x 的 值 

>>> y 

>>> val x = "abc" //x!==null, 返回 x 的 值 

>>> val y = x?:0 

>>> y 

abc 


10. 比较 操作 符 


Kotlin 中 所 有 的 比较 表达 式 都 转换 为 对 compareTo0 函 数 的 调用 , 这 个 函数 需要 返回 Int 
具体 的 对 应 关系 如 表 2-19 所 示 。 


表 2-19 比较 操作 符 


翻 译 为 


a>b a.compareTo(b) > 0 


a<b a.compareTo(b) < 0 


a.compareTo(b) >= 0 


a.compareTo(b) <= 0 
11. 用 infix 函 数 自 定义 中 组 操作 符 

我 们 可 以 通过 自 定义 infix 函数 来 实现 中 缀 操作 符 。 代 码 示例 如 下 : 

data class Person(val name: String, val age: Int) // 声 明 Person 数据 类 


infix fun Person.grow(years: Int): Person { // 声 明 Person 类 型 的 中 缀 操作 符 函 数 
return Person(name, age + years) 


} 
测试 代码 如 下 : 
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package com.easy.kotlin 


import org.junit.Test 
import org.junit.runner.RunWith 
import org.junit.runners.JUnit4 


@RunWith (JUnit4::class) 
class InfixFunctionDemoTest { 


@Test fun testInfixFuntion() { 
val person = Person("Jack", 20) 


println(person.grow(2)) // 直 接 调用 函数 
println(person grow 2) // 中 缀 表达 式 调用 方式 


} 
输出 如 下 : 


Person (name=Jack, age=22) 
Person (name=Jack, age=22) 
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我 们 在 *.kt 源 文 件 开头 声明 package 命名 空间 。 例 如 ， 在 PackageDemo.kt 源 代码 中 ， 
按照 如 下 方式 声明 包 : 


package com.easy.kotlin // 声 明 包 


fun what () { // 包 级 函数 
println ("This is WHAT ?") 
} 


fun main(args:Array<String>) { // 一 个 包 下 面 只 能 有 一 个 main() 函数 
println("Hello,World!") 
} 


class Motorbike{ // 包 里 面 的 类 
fun drive 
println("Drive The Motorbike ...") 


} 
} 
Kotlin 中 的 目录 与 包 的 结构 无 须 匹 配 ， 源 代码 文件 可 以 在 文件 系统 中 的 任意 位 置 。 
如 果 一 个 测试 类 PackageDemoTest 与 PackageDemo 在 同一 个 包 下 面 , 我 们 就 不 需要 单 
独 去 导入 类 和 包 级 函数 ， 可 以 在 代码 里 直接 调用 。 


package com.easy.kotlin 
import org.junit.Test 
import org.junit.runner.RunWith 


import org.junit.runners.JUnit4 


@RunWith (JUnit4::class) 
class PackageDemoTest { 


DER? 


第 2 章 Kotlin 语法 基础 


@Test 
fun testWhat() { 


what () // 同 一 个 包 命名 空间 下 的 函数 可 以 直接 调用 
} 


@Test 

fun testDriveMotorbike() { 
val motorbike = Motorbike () 
motorbike.drive() 


} 


其 中 ，what() 函 数 与 PackageDemoTest 类 在 同一 个 包 命名 空间 下 ， 因 此 可 以 直接 调用 ， 
不 需要 导入 。Motorbike 类 与 PackageDemoTest 类 同 理 分 析 。 

如 果 不 在 同一 个 包 下 面 , 我 们 就 需要 导入 对 应 的 类 和 函数 。 例 如 , 我 们 在 src\test\kotlin 
目录 下 新 建 一 个 package com.easy.kotlin.test, 使 用 package com.easy.kotlin 下 面 的 类 和 函数 ， 
示例 如 下 : 


package com.easy.kotlin.test 


import com.easy.kotlin.Motorbike //A2 Motorbike 
import com.easy.kotlin.what // 导 入 包 级 函数 what () 
import org.junit.Test 

import org.junit.runner.RunWith 

import org.junit.runners.JUnit4 


@RunWith (JUnit4::class) 
class PackageDemoTest { 


@Test 

fun testWhat() { 
what () 

} 


@Test 

fun testDriveMotorbike() { 
val motorbike = Motorbike () 
motorbike.drive () 


} 
Kotlin 会 默认 导入 一 些 基础 包 到 每 个 Kotlin 文件 中 : 


kotlin.* 

kotlin.annotation.* 
kotlin.collections.* 
kotlin.comparisons.* ( 自 1.1 起 ) 
kotlin.io.* 

kotlin.ranges.* 
kotlin.sequences.* 
kotlin.text.* 


根据 目标 平台 还 会 导入 额外 的 包 。 
O JVM 平台 上 会 默认 导入 下 面 的 包 ， 


java.lang.* 
kotlin.jvm.* 


D JS 平台 上 会 默认 导入 下 面 的 包 : 
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kotlin.js.* 


26 本 章 小 结 


通过 本 章 的 学 习 , 我 们 可 以 看 到 Kotlin 的 语法 相当 精简 , 不 像 Java AMIR, PRS 
起 代码 来 也 是 相当 方便 。 在 后 面 的 章节 中 ， 我 们 将 继续 体验 Kotlin 语言 的 魅力 。 第 3 章 将 
介绍 Kotlin 的 类 型 系统 与 可 空 类 型 。 
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与 Java, C 和 C ++ 语 言 一 样 ，Kotlin 语言 也 是 “静态 类 型 的 编程 语言 ”。 通 常 ， 编 程 
语言 中 的 类 型 系统 中 定义 了 : 

口 如 何 将 数值 和 表达 式 归 为 不 同 的 类 型 ; 

口 如 何 操作 这 些 类 型 ; 

口 这 些 类 型 之 间 如 何 互相 作用 。 

我 们 在 编程 语言 中 使 用 类 型 的 目的 是 为 了 让 编译 器 能 够 确定 类 型 所 关联 的 对 象 需要 
分 配 多 少 空间 。 

类 型 系统 在 各 种 语言 之 间 有 非常 大 的 差异 ， 主 要 的 差异 表现 在 编译 时 期 的 语法 及 运行 
时 期 的 操作 实现 方式 上 。 在 每 一 种 编程 语言 中 ， 都 有 一 个 特定 的 类 型 系统 。 静 态 类 型 在 编 
译 时 期 就 能 可 靠 地 发 现 类 型 错误 ， 因 此 通常 能 增进 最 终 程序 的 可 靠 性 。 然 而 ， 有 多 少 的 类 
型 错误 发 生 ， 以 及 有 多 少 比 例 的 错误 能 被 静态 类 型 所 捕获 ， 仍 有 争论 。 

本 章 简单 介绍 一 下 Kotlin 的 类 型 系统 。 
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定型 (typing， 又 称 类 型 指派 ) 的 过 程 就 是 赋予 一 组 比特 以 具体 的 意义 。 类 型 通常 和 
存储 器 中 的 数值 或 对 象 〈 如 变量 ) 相 联系 。 因 为 在 计算 机 中 ， 任 何 数值 都 是 由 一 组 简单 的 
比特 位 组 成 的 ， 硬 件 无 法 区 分 存储 器 地 址 、 脚 本 、 字 符 、 整 数 及 浮 点 数 。 类 型 可 以 告知 程 
序 和 程序 设计 者 ， 应 该 怎么 对 待 那些 比特 位 。 


3.1.1 类 型 系统 的 作用 


使 用 类 型 系统 ， 编 译 器 可 以 检查 无 意义 的 、 无 效 的 、 类 型 不 匹配 等 错误 代码 。 这 也 正 
是 强 类 型 语言 能 够 提供 更 多 的 代码 安全 性 保障 的 原因 之 一 。 

另外 ， 静 态 类 型 检查 还 可 以 提供 有 用 的 信息 给 编译 器 。 与 动态 类 型 语言 相 比 ， 由 于 有 
了 类 型 的 显 式 声明 ， 静 态 类 型 的 语言 更 加 易 读 好 懂 。 

有 了 类 型 ， 我 们 还 可 以 更 好 地 做 抽象 化 、 模 块 化 的 工作 。 这 使 得 我 们 可 以 在 较 高 抽象 
层次 思考 并 解决 问题 。 例 如 ，Java 中 的 字符 数组 char[]s={'a','b',c'} 和 字符 串 类 型 String 
str="abc" 就 是 最 简单 、 最 典型 的 抽象 封装 实例 。 下 面 分 别 举例 说 明 。 

字符 数组 代码 示例 如 下 : 
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jshell> char[] s = 
s ==> char[3] { 'a' 


{ta','b','c'} //F FA 


sa, cea 
jshell> s[0] // 访 问 第 一 个 元 素 ， 注 意 下 标 是 0 
$3 ==> 'a' 


jshell> s[1] 
$4 ==> "bi 


jshell> s[2] 
$5 ==> 'c' 


字符 串 代码 示例 如 下 : 


jshell> String str = "abc" // 声 明 字符 串 
str ==> "abc" 


jshell> str.toCharArray (); //String 类 型 转换 成 字符 数组 
El "bt fen f 


3.1.2 Java 类 型 系统 


Java 类 型 系统 可 以 简单 用 下 面 的 图 3-1 来 表示 。 


byte 


基本 数据 类 型 在 被 
创建 时 ， 在 栈 上 给 
其 划分 一 块 内 存 ， 


数值 型 


基本 类 型 (primitives) 将 数值 直接 存储 
字符 型 © char ERE 
布尔 型 © _ boolean 
类 类 型 (class types) 引用 数据 型 在 被 创建 
时 ， 首 先 在 栈 上 给 其 


Hz] SE (interface types) 

数组 类 型 (array types) EE oun S 
参数 化 类 型 ( 泛 型 ，type variables)( 体 信息 存储 在 堆 内存 
注解 (Annotation) 上 ， 然 后 由 栈 上 面 的 
枚 举 类 型 (enumeration type) 引用 指向 堆 中 对 象 的 


引用 类 型 (reference types) 


地 址 
一 个 特殊 的 引用 值 © 空 引用 null 
图 3-1 Java 类 型 系统 
关于 Java 中 的 nul， 有 很 多 比较 “ 坑 ” 的 地 方 。 例 如 : 
int i = null; //type mismatch : cannot convert from null to int 
short s = null; //type mismatch : cannot convert from null to short 
byte b = null: //type mismatch : cannot convert from null to byte 
double d = null; //type mismatch : cannot convert from null to double 
Integer io = null; // 编 译 
int j = io; // 编 译 ok， 但 运行 时 报 NullPointerException 


基本 数据 类 型 与 引用 数据 类 型 在 创建 时 ， 内 存 存储 方式 区 别 如 下 : 
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D 基本 数据 类 型 在 被 创建 时 , 在 栈 上 给 其 划分 一 块 内 存 , 将 数值 直接 存储 在 栈 上 (性 
能 高 ) ; 

O 引用 数据 类 型 在 被 创建 时 ， 首 先 在 栈 上 给 其 引用 《和 句柄 ) 分 配 一 块 内 存 ， 而 对 象 
的 具体 信息 存储 在 堆 内 存 上 ， 然 后 由 栈 上 面 的 引用 指向 堆 中 对 象 的 地 址 。 


3.1.3 Kotlin 的 类 型 系统 


Java 是 一 个 近乎 “纯洁 ”的 面向 对 象 编程 语言 ， 但 是 为 了 编程 方便 还 是 引入 了 基本 数 
据 类 型 。 为 了 能 够 将 这 些 基 本 数据 类 型 当成 对 象 操作 ，Java 为 每 一 个 基本 数据 类 型 都 引入 
了 对 应 的 包装 类 型 (wrapper class) , int 的 包装 类 型 就 是 Integer， 从 Java 5 开始 引入 了 自 
动 装 箱 / 拆 箱 机 制 ， 使 得 二 者 可 以 相互 转换 。Java 为 每 个 原始 类 型 提供 了 相应 的 包装 类 型 。 

口 原始 类 型 : boolean, char, byte, short, int, long, float, double. 

口 相应 的 包装 类 型 : Boolean, Character, Byte, Short, Integer, Long, Float, Double. 

Kotlin 中 去 掉 了 原始 类 型 ， 只 有 包装 类 型 ， 编 译 器 在 编译 代码 的 时 候 ， 会 自动 优化 性 
能 ， 把 对 应 的 包装 类 型 拆 箱 为 原始 类 型 。 

Kotlin 系统 类 型 分 为 可 空 类 型 和 不 可 空 类 型 。Kotlin 中 引入 了 可 空 类 型 ， 把 有 可 能 为 
null 的 值 单独 用 可 空 类 型 来 表示 。 这 样 就 在 可 空 引用 与 不 可 空 引 用 之 间 划 分 出 一 条 明确 的 、 
显 式 的 “界线 ”。 

Kotlin 类 型 层次 结构 如 图 3-2 所 示 。 


String 


图 3-2 Kotlin 类 型 层次 结构 


通过 这 样 显 式 地 使 用 可 空 类 型 ， 并 在 编译 期 作 类 型 检查 ， 大 大 降低 了 出 现 空 指针 异常 
的 概率 。 

对 于 Kotlin 中 的 数字 类 型 而 言 ， 不 可 空 类 型 与 Java 中 原始 的 数字 类 型 对 应 ， 如 表 3-1 
所 示 。 

Kotlin 中 对 应 的 可 空 数字 类 型 就 相当 于 Java 中 的 装 箱 数字 类 型 ， 如 表 3-2 所 示 。 
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表 3-1 Kotlin 中 的 数字 类 型 与 Java 中 原始 的 数字 类 型 


Kotlin Java 
Int int 
Long long 
Float float 
Double double 


# 3-2 ”Kotlin 中 的 可 空 数字 类 型 与 Java 中 的 装 箱 数字 类 型 


Kotlin Java 
Int? Integer 
Long? Long 
Float? Float 
Double? Double 


在 Java 中 , 从 基本 数字 类 型 到 引用 数字 类 型 的 转换 过 程 就 是 典型 的 装 箱 操作 , 例如 int 
转 为 mteger。 倒 过 来 ， 从 Integer HA int 就 是 拆 箱 操作 。 同 理 ， 在 Kotlin 中 非 空 数字 类 型 
Int 到 可 空 数字 类 型 mt? 需 要 进行 装 箱 操作 。 同 时 ， 非 空 的 Int 类 型 会 被 编译 器 自动 拆 箱 成 
基本 数据 类 型 int， 存储 的 时 候 也 会 存 到 栈 空间 。 例 如 下 面 的 代码 ， 当 为 Int 类 型 的 时 候 ， 
a===b 返回 的 是 true; 而 当 为 nH, a=b 返回 的 是 false。 


>>> val a: Int = 1000 
>>> val b:Int = 1000 


>>> a===b // 引 用 相等 

true 

>>> a==b // 值 相等 

true 

上 面 返回 的 都 是 tue， 因 为 a、b 它们 都 是 以 原始 类 型 存储 的 ， 类 似 于 Java 中 的 基本 
数字 类 型 。 

>>> val a:Int? = 1000 

>>> val b:Int? = 1000 

>>> a==b 

true 

>>> a===b // 可 空 类 型 Int? 等 价 于 Java 中 的 Integer 包装 类 型 ， 这 里 a、b 引用 不 相等 

false 


可 以 看 出 ， 当 a、b 都 为 可 空 类 型 时 ，a 与 b 的 引用 是 不 等 的 。“ 等 于 ”号 的 简单 说 明 
如 表 3-3 所 示 。 


表 3-3 Kotlin 中 的 “等 于 ”号 说 明 


“等 于 ”符号 功能 说 明 


| 赋值 ， 在 逻辑 运算 时 也 有 效 


| 等 于 运算 ， 比 较 的 是 值 ， 而 不 是 引用 


= 完全 等 于 运算 ， 不 仅 比较 值 ， 而 且 还 比较 引用 ， 只 有 两 者 一 致 才 为 真 


另外 ，Java 中 的 数组 也 是 一 个 较为 特殊 的 类 型 。 这 个 类 型 是 T[]， 这 个 方 括号 让 我 们 
觉得 不 太 “ 优 雅 ”。Kotlin 中 握 弃 了 这 个 数组 类 型 声明 的 语法 。 Kotlin 简单 直接 地 使 用 Array 
类 型 代表 数组 类 型 。 这 个 Array 中 定义 了 get、set 算 子 函数 ， 同 时 有 一 个 size 属性 代表 数 
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组 的 长 度 ， 还 有 一 个 返回 数组 元 素 的 迭代 子 Iterator 的 函数 iterator()。 完 整 的 定义 如 下 : 


public class Array<T> { 
public inline constructor(size: Int, init: (Int) -> T) 
public operator fun get (index: Int): T 
public operator fun set (index: Int, value: T): Unit 
public val size: Int 
public operator fun iterator(): Iterator<T> 


I 
其 中 ， 构 造 函 数 我 们 可 以 这 么 用 : 


>>> val square = Array(5, {i -> i * i }) // 构 造 5 个 元 素 的 数组 ， 元 素 初始 值 是 iti 
>>> square.forEach(::println) 

0 

1 

4 

9 

16 


在 编程 过 程 中 常用 的 是 boolean[]、 char[]、 byte[]、 short[]、 int[]、 long[]、 float[]、 double[]; 
Kotlin 直接 使 用 了 8 个 新 的 类 型 来 对 应 这 样 的 编程 场景 : 


BooleanArray 
ByteArray 
CharArray 
DoubleArray 
FloatArray 
IntArray 
LongArray 
ShortArray 


32 可 空 类 型 


或 许 Java 和 Android 开发 者 早已 厌倦 了 空 指针 异常 (Null Pointer Exception) 。 因 为 其 
在 运行 时 总 会 在 某 个 意 想不到 的 地 方 忽然 出 现 ， 让 开发 者 感到 措手不及 。 

那么 为 何 开发 者 不 能 在 编译 时 就 提前 发 现 这 类 空 指针 异常 ， 并 大 量 修复 这 些 问题 呢 ? 
现代 编程 语言 正 是 这 么 做 的 。Kotlin 自然 也 不 例外 。 在 Java 8 中 ， 我 们 可 以 使 用 Optional 
类 型 来 表达 可 空 的 类 型 。 

package com.easy.kotlin; 


import java.util.Optional; 
import static java, Lang. System. out: 


public class Java80OptionalDemo { 
public static void main(String[] args) { 
out.printin(strLength (Optional.of ("abc"))); 
out .printin(strLength (Optional.ofNullable (null) )); 
} 


static Integer strLength(Optional<String> s) { 
return s.orElse("") .length(); 
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//Optional 类 型 中 的 orElse 方法 ， 等 价 于 ELvis 表达 式 的 逻辑 
} 
$ 


运行 程序 ， 输 出 如 下 : 
3 
0 


但 是 这 样 的 代码 依然 不 是 那么 “优雅 ”。 
针对 这 方面 ，Groovy 提供 了 一 种 安全 的 属性 /方法 访问 操作 符 “?.”: 


user? .getUsername () ?.toUpperCase () ; // 安 全 调用 符 2. 


Swift 也 有 类 似 的 语法 ， 只 作用 在 Optional 的 类 型 上 。 

Kotlin 中 使 用 了 Groovy 里 面 的 安全 调用 符 , 并 简化 了 Optional 类 型 的 使 用 ,直接 通过 
在 类 型 工 后 面 加 个 “?”， 就 表达 了 Optional 的 意义 。 

上 面 Java 8 的 例子 用 Kotlin 来 写 就 显得 更 加 简单 、“ 优 雅 ” 了 : 


package com.easy.kotlin 


fun main(args: Array<String>) { 
printin(strLength (null) ) 
printin(strLength ("abc") ) 

} 


fun strLength(s: String?): Int { 
return s?.length ?: 0 //?. 是 安全 调用 符 ，? :是 Elvis 操作 符 
其 中 ， 我 们 使 用 String? 同 样 表 达 了 Optional 的 意思 ， 相 比 之 下 ， 哪 种 方式 更 简单 ? 答 
案 一 目 了 然 。 
还 有 Java 8 的 Optional 提供 的 orElse: 


s.orElse("") .length(); 
其 在 Kotlin 中 是 最 最 常见 的 Elvis 运算 符 了 : 
s?.length ?: 0 


相 比 之 下 ， 我 们 还 有 什么 理由 继续 用 Java 8 的 Optional 呢 ? 
3.3 安全 操作 符 


扔 掉 Java 中 的 一 堆 null 的 防御 式样 板 代码 吧 ! 当 我 们 使 用 Java 开发 的 时 候 ， 我 们 的 
代码 大 多 是 防御 性 的 。 如 果 我 们 不 想 遇 到 NullPointerException， 就 需要 在 使 用 它 之 前 不 停 
地 判断 它 是 否 为 null。 

Kotlin 正如 很 多 现代 编程 语言 一 样 是 空 安全 的 。 因 为 我 们 需要 通过 一 个 可 空 类 型 符号 
“T?” 来 明确 地 指定 一 个 对 象 类 型 工 是 否 能 为 空 。 

我 们 可 以 像 这 样 去 写 : 
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>>> val str: String = null // 编 译 不 通过 : 不 可 空 String 类 型 的 str 禁止 赋值 null 
error: null can not be a value of a non-null type String 
val str: String = null 


可 以 看 到 ， 这 里 不 能 通过 编译 ， 因 为 String 类 型 不 能 是 null。 
一 个 可 以 赋值 为 null 的 String 类 型 的 正确 写法 是 : String?， 代 码 如 下 : 


>>> var nullableStr: String? = null 


// 可 空 类 型 String?, nullableStr 可 能 会 导致 空 指针 异常 
>>> nullableStrnull 


我 们 再 来 看 一 下 Kotlin 中 关于 null 的 一 些 有 趣 的 运算 。null 与 null 是 相等 的 : 


>>> null==null 
true 
>>> null!=null 
false 


null 这 个 值 比较 特殊 ，null 不 是 Any 类 型 ， 例 如 : 


>>> null is Any 
false 


但 是 ，null 是 Any? 类 型 ， 例 如 : 


>>> null is Any? 
true 


我 们 再 来 看 看 null 对 应 的 类 型 是 什么 : 


>>> var a=null 

>>> a 

null 

>>> a=1 

error: the integer literal does not conform to the expected type Nothing? 
a=1 


~ 


从 报错 信息 中 可 以 看 出 ，null 的 类 型 是 Nothing?。 关 于 Nothing? 的 内 容 ， 将 会 在 后 面 
介绍 。 


3.3.1 安全 调用 符 “?” 


我 们 不 能 直接 使 用 可 空 的 nullableStr 来 调用 其 属性 或 者 方法 ， 例 如 下 面 的 代码 直接 
报错 : 


>>> nullableStr.length 

error: only safe (?.) or non-null asserted (!!.) calls are allowed on a 
nullable receiver of type String? 

nullableStr.length 


上 面 的 代码 无 法 编译 ,nullableStr 可 能 是 null。 我 们 需要 使 用 安全 调用 符 “?.” 来 调用 : 


>>> var nullableStr: String? = null 
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3:3: 


>>> nullableStr?.length 

null 

>>> null ableStr = "abc" 

>>> nullableStr?.length // 安 全 调用 符 “?.” 


只 有 在 nullableStr!=null 时 才 会 去 调用 其 length 属性 。 
2 非 空 断言 “!!” 


Kotlin 中 提供 了 断言 操作 符 “!!”， 使 得 可 空 类 型 对 象 可 以 调用 成 员 方 法 或 者 属性 (但 


遇见 null， 就 会 导致 空 指针 异常 》， 代 码 示例 如 下 : 


3.3. 


>>> nullableStr = null 
>>> nullableStr!!.length // 抛 出 空 指针 异常 
kotlin.KotlinNullPointerException 


3 Elvis 运算 符 “?:” 


使 用 Elvis 操作 符 “?:” 来 给 定 一 个 在 null 情况 下 的 蔡 代 值 : 


>>> nullableStr 

null 

>>> var s= nullableStr?:"NULL" // 当 s Æ null 的 时 候 ， 返 回 "NULL" 字 符 串 
>>> s 

NULL 


3.4 特殊 类 型 


本 节 我 们 介绍 Kotlin 中 的 特殊 类 型 : Unit、Nothing、Any 及 其 对 应 的 可 空 类 型 Unit?、 


Nothing?, Any?. 


3.4. 


值 、 


1 Unit 类 型 


Kotlin 也 是 面向 表达 式 的 语言 。 在 Kotlin 中 所 有 控制 流 语 句 都 是 表达 式 〈 除 了 变量 赋 
异常 等 ) 。 
Kotlin 中 的 Unit 类 型 实现 了 与 Java 中 的 void 一 样 的 功能 。 总 的 来 说 ， 这 个 Unit 类 型 


并 没有 什么 特别 之 处 。 它 的 定义 如 下 : 


package kotlin 

public object Unit { //Unit 类 型 是 一 个 object 对 象 类 型 
override fun toString() ="kotlin.Unit" //toString () 函数 返回 值 

} 


不 同 的 是 , 当 一 个 函数 没有 返回 值 的 时 候 , 我 们 用 Unit 来 表示 这 个 特征 , 而 不 是 null。 
大 多 数 时 候 ， 我 们 并 不 需要 显 式 地 返回 Unit， 或 者 声明 一 个 函数 的 返回 类 型 为 Unit。 
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编译 器 会 推断 出 它 。 代 码 示例 如 下 : 


>>> fun unitExample() {println("Hello,Unit")} 
>>> val helloUnit = unitExample() 

Hello, Unit 

>>> helloUnit // 函 数 的 返回 类 型 是 Unit 
kotlin.Unit 

>>> println (helloUnit) 

kotlin.Unit 

>>> helloUnit is Unit // 判 断 是 否 Unit 类 型 
true 


可 以 看 出 ， 变 量 helloUnit 的 类 型 是 kotlin.Unit。 下 面 几 种 写法 是 等 价 的 : 


@RunWith (JUnit4::class) 
class UnitDemoTest { 

@Test fun testUnitDemo() { 
val url = unitReturnl () 
println(url) //kotlin.Unit 
val ur2 = unitReturn2() 
println(ur2) //kotlin.Unit 
val ur3 = unitReturn3() 
println(ur3) //kotlin.Unit 

} 


fun unitReturnl() { // 空 函数 体 ， 返 回 类 型 是 Unit 
} 
fun unitReturn2() { // 显 式 return 
return Unit 
} 
fun unitReturn3(): Unit { // 显 式 声明 返回 类 型 Unit 
} 
} 
跟 其 他 类 型 一 样 ，Kotlin.Unit 父 类 型 是 Any。 如 果 是 一 个 可 空 的 Unit?， 那 么 父 类 型 是 
Any?。Unit 类 型 层次 结构 如 图 3-3 所 示 。 


Unit? Any 


图 3-3 Unit 类 型 层次 结构 


3.4.2 Nothing 与 Nothing? 类 型 


在 Java 中 ，void 不 能 是 变量 的 类 型 ， 也 不 能 作为 值 打 印 输出 。 但 是 在 Java 中 有 个 包 
装 类 Void 是 void 的 自动 装 箱 类 型 。 如 果 你 想 让 一 个 方法 的 返回 类 型 永远 是 null 的 话 ， 可 
以 把 返回 类 型 置 为 这 个 大 写 的 Void 类 型 。 
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代码 示例 如 下 : 
public Void voidDemo() { // 声 明 方 法 的 返回 类 型 是 Void 
System.out.println ("Hello,Void"); 
return null; // 这 个 返回 类 型 void 的 方法 只 能 返回 null 值 
F 
测试 代码 如 下 : 


@RunWith (JUnit4.class) 
public class VoidDemoTest { 
@Test 
public void testVoid() { 
VoidDemo voidDemo = new VoidDemo () ; 
Void v = voidDemo.voidDemo () ; // 输 出 : Hello, Void 
System.out.println(v); // 输 出 : null 


} 


这 个 Void 对 应 Kotlin 中 的 Nothing?， 其 唯一 可 被 访问 的 返回 值 也 是 null。 
如 3.13 节 中 的 Kotlin 类 型 层次 结构 图 (图 3-2) 所 示 ， 在 Kotlin 类 型 层次 结构 的 最 底 
层 就 是 Nothing 类 型 ，Nothing 类 型 层次 结构 如 图 3-4 所 示 。 


String? | Int? | MyClass? 


3-4 Nothing 类 型 层次 结构 


Nothing 类 的 定义 如 下 : 


public class Nothing private constructor () 


//Nothing 的 构造 函数 是 private 的 ， 外 界 无 法 创建 Nothing HR 


这 个 Nothing0 不 能 被 实例 化 : 
>>> Nothing() is Any  ”// 不 能 实例 化 ， 因 为 默认 的 主 构造 函数 是 私有 的 


error: cannot access '<init>': it is private in 'Nothing' 
Nothing() is Any 
天 


从 上 面 的 代码 示例 中 可 以 看 出 Nothing0 不 可 被 访问 。 如 果 一 个 函数 的 返回 值 是 Nothing， 
就 意味 着 这 个 函数 永远 不 会 有 返回 值 。 

但 是 我 们 可 以 使 用 Nothing 来 表达 一 个 从 来 不 存在 的 返回 值 .例如 EmptyList 中 的 get() 
函数 

internal object EmptyList : List<Nothing>, Serializable, RandomAccess { 


override fun get (index: Int): Nothing = throw IndexOutOfBoundsException 
("Empty list doesn't contain element at index $index.") 


//get 函数 的 返回 类 型 是 Nothing 
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i 


一 个 空 的 List 调用 get0 函 数 , 直接 抛 出 了 IndexOutOfBoundsException, 这 个 时 候 可 以 
使 用 Nothing 作为 这 个 getO 函 数 的 返回 类 型 ， 因 为 它 永远 不 会 返回 某 个 值 ， 而 是 直接 抛 出 
了 异常 。 

再 例如 Kotlin 标准 库 里 面 的 exitProcess0 〇 函数 : 

@file:kotlin.jvm.JvmName ("ProcessKt") 

@file:kotlin.jvm.JvmVersion 

package kotlin.system 

@kotlin.internal.InlineOnly 

public inline fun exitProcess(status: Int): Nothing { 

//exitProcess 函数 的 返回 类 型 是 Nothing 
System.exit (status) 
throw RuntimeException("System.exit returned normally, while it was 
supposed to halt JVM.") 

} 


AE: Unit 5 Nothing 之 间 的 区 别 是 ，Unit 类 型 表达 式 计算 结果 的 返回 类 型 是 Unit; 
Nothing 类 型 的 表达 式 计 算 结果 是 永远 不 会 返回 的 (与 Java 中 的 void 相同 ) 。 


Nothing? 可 以 只 包含 一 个 值 null。 代 码 示例 如 下 : 


>>> var nul:Nothing?=null 


>>> nul = 1 //Nothing? 除 了 null 值 之 外 ， 不 能 赋 其 他 值 
error: the integer literal does not conform to the expected type Nothing? 
nul=1 


A 


>>> nul = true 
error: the boolean literal does not conform to the expected type Nothing? 


nul = true 
A 


>>> nul = null //Nothing? 只 能 赋值 为 null 值 
>>> nul 
null 


从 上 面 的 代码 示例 中 可 以 看 出 :; Nothing? 唯 一 允许 的 值 是 null， 可 被 用 作 任 何 可 空 类 
型 的 空 引 用 。 


3.4.3 Any 与 Any? 类 型 


就 像 Any 是 在 非 空 类 型 层次 结构 的 根 一 样 ，Any? 是 可 空 类 型 层次 的 根 。Any? 是 Any 
的 超 集 ，Any? 是 Kotlin 类 型 层次 结构 的 最 顶端 Any 类 型 层次 结构 如 图 3-5 所 示 。 


图 3-5 Any 类 型 层次 结构 
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代码 示例 : 

>>> 1 is Any //Int 类 型 的 1 Any 类 型 
true 

>>> 1 is Any? //Int 类 型 的 1 是 Any? 类 型 
true 

>>> null is Any //null 不 是 Any 类 型 
false 

>>> null is Any? //null 是 Any? 类 型 

true 

>>> Any() is Any? //Any() 是 Any? 类 型 
true 


3.5 ”类 型 检测 与 类 型 转换 


Kotlin 在 运行 时 通过 使 用 is 操作 符 或 其 否定 形式 !is 来 检查 对 象 是 否 符合 给 定 类 型 。 在 
一 般 情况 下 ， 不 需要 在 Kotlin 中 使 用 显 式 转换 操作 符 ， 因 为 编译 器 跟踪 不 可 变 值 的 is 检 
查 ， 并 在 需要 时 自动 插入 〈 安 全 的 ) 转换 。 下 面 分 别 具 体 介绍 。 


3.5.1 is 运算 符 


is 运算 符 可 以 检查 对 象 A 是 否 与 特定 的 类 型 X 兼容 〈 此 对 象 A 是 X 类 型 或 者 派生 于 
X 类 型 )， 还 可 以 用 来 检查 一 个 对 象 〈 变 量 ) 是 否 属于 某 数据 类 型 (如 Int, String, Boolean 
等 ) 。C# 里 面 也 有 is 运算 符 。 

is 运算 符 类 似 Java 中 的 instanceof: 


jshell> "abc" instanceof String //Java 中 的 instanceof 操作 符 
$10 ==> true 


在 Kotlin 中 , 我 们 可 以 在 运行 时 通过 使 用 is 运算 符 或 其 否定 形式 !is， 来 检查 对 象 是 否 
符合 给 定 类 型 : 


>>> "abc" is String 
true 
>>> "abc" !is String 
false 


>>> null is Any 
false 
>>> null is Any? 
true 


代码 示例 如 下 : 


@RunWith (JUnit4::class) 
class ISTest { 
@Test fun testIS() { 
val foo = Foo() 
val goo = Goo() 
println(foo is Foo) //true 


252° 


第 3 章 类 型 系统 与 可 空 类 型 


println (goo is Foo) // 子 类 is 父 类 =true 


println (foo is Goo) // 父 类 is 子 类 =false 
println(goo is Goo) //true 


i 


open class Foo 
class Goo : Foo() 


3.5.2 ”类 型 自动 转换 


在 Java 代码 中 ， 当 我 们 使 用 str instanceof String 来 判断 其 值 为 tue 的 时 候 ， 我 们 想 使 
用 str 变量 ， 还 需要 显 式 地 强制 转换 类 型 ; 


@RunWith (org.junit.runners.JUnit4.class) 
public class TypeSystemDemo { 
@org.junit.Test 
public void testVoid() { 
Object str = "abc"; 
if (str instanceof String) { 
int len = ((String)str).length(); // 显 式 地 强制 转换 类 型 为 String 
println(str + " is instanceof String"); 
println("Length: " + len); 
} else { 
println(str + " is not instanceof String"); 
} 
boolean is = "1" instanceof String; 
println (is); 
} 
void println(Object obj) { 
System.out.printl1n (obj); 
} 
} 


而 大 多 数 情况 下 不 需要 在 Kotlin 中 使 用 显 式 转换 操作 符 ， 因 为 编译 器 会 跟踪 不 可 变 值 
的 is 检查 ， 并 在 需要 时 自动 插入 《安全 的 ) 转换 : 


@Test fun testIS() { 
val len = strlen("abc") 
printin(len) //3 
val lens = strlen(1) 
println (lens) //1 

} 


fun strlen(ani: Any): Int { 


if (ani is String) { //ani 变量 的 类 型 如 果 是 String 类 型 ， 编 译 器 会 存储 它 的 类 型 


return ani.length 
// 这 里 的 ani 类 型 已 经 是 String， 可 以 直接 作为 String 类 型 使 用 
} else if (ani is Number) { 
return ani.toString() .length 
} else if (ani is Char) { 
return 1 
} else if (ani is Boolean) { 
returm l 
} 
print ("Not A String") 
return -1 
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3.5; 


3 as 运算 符 


as 运算 符 用 于 执行 引用 类 型 的 显 式 类 型 转换 。 如 果 要 转换 的 类 型 与 指定 的 类 型 兼容 ， 


转换 就 会 成 功 进行 ， 如 果 类 型 不 兼容 ， 使 用 as? 运 算 符 就 会 返回 null。 


代码 示例 如 下 : 
>>> open class Foo // 父 类 Foo 
>>> class Goo:Foo() // 子 类 Goo 


>>> val foo = Foo() 

>>> val goo = Goo() 

>>> foo as Goo // 父 类 型 不 能 强制 转换 为 子 类 型 
java.lang.ClassCastException: Line69$Foo cannot be cast to Line71$Goo 
>>> foo as? Goo 

null 

>>> goo as Foo // 子 类 型 可 以 转换 为 父 类 型 

Line71$Goo0@73dce0e6 


可 以 看 出 ， 在 Kotlin 中 ， 父 类 是 禁止 转换 为 子 类 型 的 。 
按照 Liskov 替换 原则 ， 父 类 转换 为 子 类 是 对 OOP 的 严重 违反 ， 因 为 子 类 除了 包含 父 


类 所 有 的 方法 和 属性 之 外 ， 还 可 以 自 定义 成 员 方法 与 属性 ， 而 父 类 则 未 必 具 有 和 子 类 同样 
的 成 员 ， 所 以 这 种 转换 是 不 允许 的 。 


36 本 章 小 结 


Kotlin 通过 引入 可 空 类 型 ， 在 编译 时 就 大 量 “ 清 扫 了 ” 空 指针 异常 。 同 时 ，Kotlin 中 


还 引入 了 安全 调用 符 “?.” 及 Elvis 操作 符 “?:”， 使 得 我 们 的 代码 写 起 来 更 加 简洁 。 


Kotlin 的 类 型 系统 比 Java 更 加 简单 、 一 致 ，Java 中 的 原始 类 型 与 数组 类 型 在 Kotlin 中 


都 统一 表现 为 引用 类 型 。 


Kotlin 中 还 引入 了 Unit, Nothing 等 特殊 类 型 ,使 得 没有 返回 值 的 函数 与 永远 不 会 返回 


的 函数 有 了 更 加 规范 和 一 致 的 签名 。 


我 们 可 以 使 用 is 操作 符 来 判断 对 象 实例 的 类 型 ， 使 用 as 操作 符 进行 类 型 的 转换 。 
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在 前 面 的 章节 中 ， 我 们 学 习 了 Kotlin 的 语言 基础 知识 、 类 型 系统 等 相关 的 知识 。 本 章 
及 第 5 章 将 一 起 学 习 Kotlin 面向 对 象 编程 和 函数 式 编程 的 支持 。 
本 章 主 要 介绍 Kotlin 面向 对 象 编程 的 知识 。 


4.1 面向 对 象 编程 简 史 


20 世纪 50 年 代 后 期 ， 在 用 Fortran 语言 编写 大 型 程序 时 ， 由 于 没有 封装 机 制 ， 那 个 时 
候 的 变量 都 是 “全 局 变量 ”， 因 此 会 不 可 避免 地 经 常 出 现 变量 名 冲突 问题 。 在 ALGOL60 
中 (1960 年 ) 采用 了 以 Begin End 为 标识 的 程序 块 ， 使 块 内 变量 名 是 局 部 的 ， 以 避免 它们 
与 程序 中 块 外 的 同名 变量 相 冲突 。 在 编程 语言 中 首次 提供 了 封装 〈 保 护 ) 机 制 。 此 后 ， 程 
序 块 结构 广泛 用 于 Pascal、Ada、C 语言 等 高 级 语言 中 。 

20 世纪 60 年 代 中 后 期 ， 在 ALGOL 基础 上 研制 开发 了 Simula 语言 ， 它 在 ALGOL 块 
结构 概念 的 基础 上 提出 了 对 象 的 概念 并 使 用 了 类 , 也 支持 类 继承 。 其 后 的 发 展 简 史 如 图 4-1 
所 示 。 


60 年 代 70 年 代 80 年 代 90 年 代 


Simula67 CLU Flex Objective-C UML(Unified Modeling language) 
并 发 Pascal Smalltalk-80 Zeg Zeg, Visual C++/BASIC 
Ada (Alan Kay) sea Delphi 
Modula-2 FU). Java 


抽象 数据 类 型 : 
数据 与 操作 封装 e 


4-1 面向 对 象 编程 发 展 简 史 


pie -+ YL (Alan Kay) Æ Smalltalk (1970 年 到 1980 年 ) 面向 对 象 编程 语言 的 发 明 人 
之 一 ， 也 是 面向 对 象 编程 思想 的 创始 人 之 一 ， 同 时 ， 他 还 是 笔记 本 电脑 最 早 的 构想 者 和 现 
代 Windows GUI 的 建筑 师 。 最 早 提出 PC 概念 和 互联 网 的 也 是 阿 伦 。 凯 ， 所 以 人 们 都 尊称 
他 为 “预言 大 师 ”。 他 是 当今 IT 界 届 指 可 数 的 技术 天 才 级 人 物 。 
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面向 对 象 编程 思想 主要 是 复 用 性 和 灵活 性 〈 弹 性 ) 。 复 用 性 是 面向 对 象 编程 的 一 个 主 
要 机 制 。 灵 活性 主要 是 应 对 变化 的 特性 ， 因 为 客户 的 需求 是 不 断 改变 的 ， 怎 样 适应 客户 需 
求 的 变化 ， 是 软件 设计 灵活 性 或 者 说 是 弹性 的 问题 。 

Java 是 一 种 面向 对 象 编程 语言 ， 它 基于 Smalltalk 语言 ， 作 为 OOP 语言 ， 它 具有 以 下 
5 个 基本 特性 。 
口 万 物 皆 对象， 每 一 个 对 象 都 会 存储 数据 ， 并 且 可 以 对 自身 执行 操作 。 因 此 ， 每 一 
个 对 象 包 含 两 部 分 : 成 员 变 量 和 成 员 方 法 。 在 成 员 方法 中 可 以 改变 成 员 变 量 的 值 。 
口 程序 是 对 象 的 集合 ， 他 们 通过 发 送 消息 来 告知 彼此 所 要 做 的 事情 ， 也 就 是 调用 相 
应 的 成 员 函 数 。 
口 每 一 个 对 象 都 有 自己 的 由 其 他 对 象 所 构成 的 存储 ， 也 就 是 说 在 创建 新 对 象 的 时 候 
可 以 在 成 员 变量 中 使 用 已 存在 的 对 象 。 
口 每 个 对 象 都 有 其 类 型 ， 每 个 对 象 都 是 某 个 类 的 一 个 实例 ， 每 一 个 类 区 别 于 其 他 类 
的 特性 就 是 可 以 向 它 发 送 什 么 类 型 的 消息 ， 也 就 是 它 定义 了 哪些 成 员 函 数 。 
O 某 一 个 特定 类 型 的 所 有 对 象 都 可 以 接受 同样 的 消息 。 另 一 种 对 对 象 的 描述 为 :对 
象 具有 状态 (数据 ， 成 员 变 量 ) 、 行 为 (操作 ， 成 员 方 法 ) 和 标识 (成 员 名 ， 内 
存 地 址 ) 。 
面向 对 象 语言 其 实 是 对 现实 生活 中 的 实物 的 抽象 。 
每 个 对 象 能 够 接受 的 请 求 ( 消 息 ) 由 对 象 的 接口 所 定义 ， 而 在 程序 中 必须 由 满足 这 些 
请 求 的 代码 ， 这 段 代码 称 为 该 接口 的 实现 。 当 向 某 个 对 象 发 送 消息 (请 求 ) 时， 这 个 对 象 
便 知 道 该 消息 的 目的 《该 方法 的 实现 已 定义 ) ， 然 后 执行 相应 的 代码 。 

我 们 经 常 说 一 些 代码 片段 是 优雅 的 或 美观 的 ， 实 际 上 是 说 它们 更 容易 被 人 类 有 限 的 思 
维 所 理解 。 对 于 程序 的 复合 而 言 ， 好 的 代码 是 它 的 “表面 积 ” 要 比 “ 体 积 ” 增 长 的 慢 。 

代码 块 的 “表面 积 ” 是 我 们 复合 代码 块 时 所 需要 的 信息 (接口 API 协议 定义 ) 。 代 码 
块 的 “体积 ”就 是 接口 内 部 的 实现 逻辑 CAPI 背后 的 实现 代码 ) 。 

在 面向 对 象 编程 中 , 一 个 理想 的 对 象 应 该 是 只 暴露 它 的 抽象 接口 ( 纯 表面 , 无 “体积 ”)， 
其 方法 则 扮演 “箭头 ”的 角色 。 如 果 为 了 理解 一 个 对 象 如 何 与 其 他 对 象 进行 复合 ， 而 不 得 
不 深入 挖掘 对 象 的 实现 之 时 ， 你 所 用 的 编程 范式 的 优势 就 荡然 无 存 了 。 

面向 对 象 编程 是 一 种 编程 思想 ， 相 比 于 早期 的 结构 化 程序 设计 ， 其 抽象 层次 更 高 ， 思 
考 解决 问题 的 方式 也 更 加 贴近 人 类 的 思维 方式 。 现 代 编 程 语言 基本 都 支持 面向 对 象 编程 范式 。 

计算 机 领域 中 的 所 有 问题 ， 都 可 以 通过 向 上 一 层 进行 抽象 封装 来 解决 。 这 里 封装 的 本 
质 是 概念 其 实 就 是 “映射 ”。 从 面向 过 程 到 面向 对 象 ， 再 到 设计 模式 ， 架 构 设 计 ， 面 向 服 
务 ，Sass、Pass 和 lass 等 思想 ， 各 种 软件 理论 思想 五 花 八 门 ， 但 万 变 不 离 其 宗 : 

你 要 解决 一 个 什么 样 的 问题 ? 

你 的 问题 是 哪个 领域 的 ? 

你 的 模型 〈 数 据 结 构 ) 是 什么 ? 

你 的 算法 是 什么 ? 

你 对 这 个 世界 的 本 质 认 知 是 怎样 的 ? 

你 的 业务 领域 的 逻辑 问题 、 流 程 是 什么 ? 


我 对 OO 编程 的 目标 从 来 就 不 是 复 用 。 相 反 ， 对 我 来 说 ， 对 象 提供 了 一 种 处 理 复杂 性 
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的 方式 。 这 个 问题 可 以 追溯 到 亚 里 士 多 德 提出 的 : 您 把 这 个 世界 视 为 过 程 还 是 对 象 ? 在 OO 
兴起 运动 之 前 ， 编 程 以 过 程 为 中 心 ， 如 结构 化 设计 方法 。 然而， 系统 已 经 到 达 了 超越 其 处 
理 能 力 的 复杂 性 极点 。 有 了 对 象 , 我 们 能 够 通过 提升 抽象 级 别 来 构建 更 大 、 更 复杂 的 系统 ， 
我 认为 ， 这 才 是 面向 对 象 编程 运动 的 真正 胜利 。 

面向 对 象 编程 以 现实 世界 中 的 事物 (对象 ) 为 中 心 来 思考 问题 ， 认 识 问题 ， 并 根据 这 
些 事物 的 本 质 特征 ， 把 它们 抽象 表示 为 系统 中 的 类 。 其 核心 思想 可 以 用 图 4-2 进行 简要 说 明 。 


计算 机 世界 


抽象 数据 类 


图 4-2 面向 对 象 编程 的 核心 思想 


面向 对 象 编程 基于 类 编程 ， 更 加 贴近 人 类 解决 问题 的 习惯 方法 ， 让 软件 世界 更 像 现实 
世界 。 面 向 对 象 编程 通过 抽象 出 关键 的 问题 域 来 分 解 系统 。 对 象 不 仅 能 表示 具体 的 事物 ， 
还 能 表示 抽象 的 规则 、 计 划 或 事件 。 关 于 面向 对 象 编程 的 基本 概念 如 图 4-3 所 示 。 
万 物 皆 对 象 ! 
程序 = 对 象 + 消息 
以 现实 世界 中 的 事务 HR) 为 中 心 来 思考 ， 认 识 问题 ， 
的 本 质 特征 ， 把 它们 抽象 表示 为 系统 中 


ESCH oo Inversion Principle) 


的 类 _ 


封装 (encapsulation) e 将 属性 与 行为 绑 定 在 一 起 


; 基于 类 编程 ， 符 合 人 类 
继承 (inheritance) © 通过 扩展 原 有 的 类 ， 声 明 新 类 解决 问题 的 思维 习惯 : 


HAR A 子 闫 可 以 拥有 超 类 的 所 有 属性 和 方法 | 让 软件 世界 更 像 现实 世界 
允许 将 子 类 类 型 的 指针 赋值 SEET 
4,28 (polymorphism) © #1 给 父 类 类 型 的 指针 gë 
基于 对 象 类 型 的 动态 分 派 对 象 不 仅 能 表示 具体 的 事务 
(dynamic dispatch) 还 能 表示 抽象 的 规则 、 计 划 
或 事件 


UML(Unified Modeling Language) 统 一 建 模 语 言 


对 象 的 属性 (数据 结构 ) 与 行为 (算法 ) 
图 4-3 面向 对 象 编程 的 基本 概念 


Cy 
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本 节 介 绍 Kotlin 中 的 类 和 构造 函数 的 相关 内 容 。 主 要 包括 类 的 声明 和 使 用 ， 以 及 构造 
函数 和 次 级 构造 函数 的 编写 。 


4.2.1 空 类 


使 用 class 关键 字 声 明 类 。 我 们 可 以 声明 一 个 什么 都 不 干 的 类 : 

class AnEmptyClass 

fun main(args: Array<String>) { 
val anEmptyClass = AnEmptyClass() //Kotlin 中 不 需要 使 用 new 
println(anEmptyClass) 
println(anEmptyClass is AnEmptyClass)  // 对 象 实例 是 AnEmptyClass 类 型 


println (anEmptyClass::class) 
I 


输出 如 下 : 


com.easy.kotlin.AnEmptyClass@2626b418 
true 
class com.easy.kotlin.AnEmptyClass (Kotlin reflection is not available) 


4.2.2 ”声明 类 和 构造 函数 


在 Kotlin 中 ， 我 们 可 以 在 声明 类 的 时 候 同时 声明 构造 函数 ， 语 法 格式 是 在 类 的 后 面 使 
用 括号 包含 构造 函数 的 参数 列表 


class Person (var name: String, var age: Int, var sex: String) { 
// 声 明 类 和 构造 函数 
override fun toString(): String { //override 关键 字 ， 重 写 toString () 
return "Person (name='$name', age=$age, sex='$sex')" 

} 
} 
使 用 这 样 简洁 的 语法 ， 可 以 通过 主 构造 器 来 定义 属性 并 初始 化 属性 值 “这 里 的 属性 值 

可 以 是 var 或 val) 。 在 代码 中 可 以 这 样 使 用 Person 类 : 


val person = Person("Jack", 29, "M") 
println("person = ${person}") 


输出 如 下 : 


person = Person (name='Jack', age=29, sex='M') 


另外 ， 也 可 以 先 声明 属性 ， 等 构造 实例 对 象 的 时 候 再 去 初始 化 属性 值 ， 那 么 Person 类 
可 以 进行 如 下 声明 : 


class Personl { 
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lateinit var name: String //lateinit 关键 字 表示 该 属性 延迟 初始 化 
var age: Int = 0 //lateinit 关键 字 不 能 修饰 primitive 类 型 
lateinit var sex: String 
override fun toString(): String { 
return "Personl(name='S$name', age=$age, sex='$sex')" 
} 
} 


我 们 可 以 在 代码 中 这 样 创建 Personl 的 实例 对 象 ; 


val personl = Personl () // 声 明 对 象 
personl.name = "Jack" // 设 置 属 性 值 
Personl .age 29 

personl.sex "M" 

println("personl = ${person1}") 


输出 如 下 : 


personl = Personl (name='Jack', age=29, sex='M') 


如 果 我 们 想 声 明 一 个 具有 多 种 构造 方式 的 类 ， 可 以 使 用 constructor 关键 字 声明 构造 函 
示例 代码 如 下 : 
class Person2() { // 无 参 的 主 构造 函数 

lateinit var name: String 


var age: Int = 0 
lateinit var sex: String 


= 


constructor(name: String) : this() { // 次 级 构造 函数 ，this 关键 字 指向 当 
前 类 对 象 实例 


this.name = name 


} 


constructor (name: String, age: Int) : this(name) { // 次 级 构造 函数 
this.name = name 
this.age = age 


} 


constructor(name: String, age: Int, sex: String) : this(name, age) { 
// 次 级 构造 函数 
this .name = name 
this.age = age 
this.sex = sex 


} 


override fun toString(): String { 
return "Personl (name='S$name', age=$age, sex='$sex')" 
} 
} 


上 面 的 写法 总 体 来 看 也 有 一 些 样板 代码 ， 其 实在 IDEA 中 ， 上 面 的 代码 只 需要 下 面 3 
行 代码 即 可 替换 ， 剩 下 的 就 交 给 IDEA 自动 生成 了 。 


class Person2 { 
lateinit var name: String 
var age: Int = 0 
lateinit var sex: String 
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在 IDEA 中 自动 生成 构造 函数 的 操作 步骤 如 下 : 
(1) 在 当前 类 中 右 击 , 在 弹出 的 快捷 菜单 中 选择 Generate 命令 (在 Mac 上 的 快捷 键 是 
Command+N) ， 如 图 4-4 所 示 。 


(2) 之 后 ， 弹 出 生成 次 级 构造 函数 对 话 框 ， 在 其 中 选择 Secondary Constructor 命令 ， 
如 图 4-5 所 示 。 
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57 GoTo > LE 

sa constructor() 36 

3 
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a p Dir "1 Recomplle'ClassDeclarationkt +%F9 

Lo 3 equals() and hashCode0 
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图 4-4 选择 Generate 命令 图 4-5 生成 次 级 构造 函数 
(3) 选择 构造 函数 的 参数 ， 如 图 4-6 所 示 。 


8 `" Choose Properties to intialize by Constructor 
E ZS 


¥_& com.casy.kotlin Person? 


w= age: Int 
> sex: String 


Cancel | | Select None 
图 4-6 选择 构造 函数 的 成 员 属 性 
选中 相应 的 属性 ， 单 击 OK 按钮 即 可 生成 构造 函数 。 一 个 属性 都 不 选 ， 生 成 


constructor () 


选择 一 个 name 属性 ， 生 成 带 name 参数 的 构造 函数 : 


constructor(name: String) { 
this.name = name 


} 
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选择 name、age 属性 ， 生 成 这 两 个 参数 的 构造 函数 : 


constructor (name: String, age: Int) : this(name) { 
this.name = name 
this.age = age 

} 

3 个 属性 都 选择 ， 生 成 这 3 个 参数 的 构造 函数 : 


constructor(name: String, age: Int, sex: String) : this(name, age) { 
this.name = name 
this.age = age 
this.sex = sex 


i 
最 后 ， 我 们 可 以 在 代码 中 这 样 创建 Person2 的 实例 对 象 : 


val person21 = Person2 () 
Person21.name = "Jack" 
person21.age = 29 

person21.sex = "M" 
println("person21 = ${person21}") 


val person22 = Person2("Jack", 29) 
person22.sex = "M" 
println("person22 = ${person22}") 


val person23 = Person2("Jack", 29, "M") 
println("person23 = ${person23}") 


实际 上 ， 我 们 在 编程 实践 中 用 到 最 多 的 构造 函数 还 是 这 个 : 


class Person (var name: String, var age: Int, var sex: String) 


当 需 要 通过 比较 复杂 的 逻辑 来 构建 一 个 对 象 的 时 候 ， 可 采用 构建 者 (Builder) 模式 来 
实现 。 


43 ”抽象 类 与 接口 


抽象 类 表示 “is-a” 的 关系 ， 而 接口 所 代表 的 是 “has-a” 的 关系 。 

抽象 类 用 来 表征 问题 领域 的 抽象 概念 。 所 有 编程 语言 都 提供 抽象 机 制 。 机 器 语言 是 对 
机 器 的 模仿 抽象 ， 汇 编 语言 是 对 机 器 语言 的 高 层次 抽象 ， 高 级 语言 (Fortran、C、BASIC 
等 ) 是 对 汇编 的 高 层次 抽象 。 而 我 们 这 里 所 说 的 面向 对 象 编程 语言 是 对 过 程 函数 的 高 层次 
封装 。 这 个 过 程 如 图 4-7 所 示 。 


厂 a. 
i 高 级 语言 | 面向 对 象 
| 机 器 e 01 机 器 码 |» SE EE Bien 


图 4-7 编程 语言 的 逐步 高 层次 封装 


抽象 类 和 接口 是 Kotlin 语言 中 两 种 不 同 的 抽象 概念 ， 它 们 的 存在 对 多 态 提供 了 非常 好 
的 支持 。 这 个 机 制 与 Java 相同 。 


DI 
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4.3.1 抽象 类 与 抽象 成 员 
抽象 是 相对 于 具象 而 言 的 。 例 如 ， 设 计 一 个 图 形 编辑 软件 ， 问 题 领 域 中 存在 着 长 方形 


(Rectangle) 、 圆 形 〈Circle) 、 三 角形 〈Triangle) 等 一 些 具体 概念 ， 它 们 是 具象 。 但 是 它 
们 又 都 属于 形状 〈Shape) 这 个 抽象 的 概念 。 它 们 的 关系 如 图 4-8 所 示 。 


Shape 


= a 


图 4-8 Shape 的 抽象 概念 


对 应 的 Kotlin 代码 如 下 : 

package com.easy.kotlin 

abstract class Shape // 声 明 抽 象 父 类 Shape 

class Rectangle : Shape() // 继 承 类 的 语法 是 使 用 冒号 “:”， 父 类 需要 在 这 里 使 用 构造 
函数 进行 初始 化 

class Circle : Shape() //Circle 继承 Shape 类 

class Triangle : Shape() //Triangle 继承 Shape 类 


因为 抽象 的 概念 在 问题 领域 中 没有 对 应 的 具体 概念 ， 所 以 抽象 类 是 不 能 够 实例 化 的 。 
下 面 的 代码 编译 器 会 报错 : 
val s = Shape() // 编 译 不 通过 ! 不 能 实例 化 抽象 类 


我 们 只 能 实例 化 它 的 继承 子 类 。 代 码 示例 如 下 : 


val r = Rectangle() 
printin(r is Shape) //true 


现在 我 们 有 了 抽象 类 ， 但 是 没有 成 员 。 通 常 ， 一 个 类 的 成 员 包 括 属 性 和 函数 。 抽 象 类 
的 成 员 也 必须 是 抽象 的 ， 需 要 使 用 abstract 关键 字 修饰 。 下 面 我 们 声明 一 个 抽象 类 Shape, 
并 带 有 width, heigth, radius 属性 和 area0 函 数 ， 代 码 如 下 : 


abstract class Shape { 
abstract var width: Double 
abstract var heigth: Double 
abstract var radius: Double 
abstract fun area(): Double 


} 
这 个 时 候 ， 继 承 抽 象 类 Shape 的 方法 如 下 : 
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class Rectangle (override var width: Double, override var heigth: Double, 
override var radius: Double) : Shape() { // 声 明 类 的 同时 也 声明 了 构造 函数 
override fun area(): Double { 
return heigth * width 
} 
} 


class Circle(override var width: Double, override var heigth: Double, 
override var radius: Double) : Shape() { 
override fun area(): Double { 
return 3.14 * radius * radius 
} 
} 


HH, override 是 覆盖 写 父 类 属性 和 函数 的 关键 字 。 在 代码 中 可 以 这 样 调用 具体 实现 
的 类 函数 : 


fun main(args: Array<String>) { 
val r = Rectangle(3.0, 4.0, 0.0) 


printin(r.area()) // 输 出 12.0 
val c = Circle(0.0, 0.0, 4.0) 
print1n(c.area()) // 输 出 50.24 


} 
抽象 类 中 可 以 有 带 实现 的 函数 ， 例 如 在 抽象 类 Shape 中 添加 一 个 函数 onClick0: 


abstract class Shape { 


fun onClick() { // 默 认 是 final 的 ， 不 可 被 覆盖 重 写 
println("I am Clicked!") 
} 
} 


那么 在 所 有 的 子 类 中 都 可 以 直接 调用 这 个 onClick0 函 数 : 


val r = Rectangle(3.0, 4.0, 0.0) // 声 明 Rectangle WR 
r.onClick() // 输 出 : I am Clicked! 
val c = Circle(0.0, 0.0, 4.0) // 声 明 Circle WR 

c.onClick() // 输 出 : I am Clicked! 


父 类 Shape 中 的 onClickO 函 数 默认 是 final 的 , 不 可 被 覆盖 重 写 。 如 果 想 要 开放 给 子 类 
重新 实现 这 个 函数 ， 可 以 在 前 面 加 上 open 关键 字 : 


abstract class Shape { 


open fun onClick() { 
println("I am Clicked!") 
} 
k 


在 子 类 中 这 样 覆盖 重 写 : 


class Rectangle(override var width: Double, override var heigth: Double, 
override var radius: Double) : Shape() {// 继 承 父 类 Shape 的 同时 声明 了 构造 函数 


override fun area(): Double { 
return heigth * width 


} 


DECH? 
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override fun onClick() { 
println("${this::class.simpleName} is Clicked!") 
} 
} 


fun main(args: Array<String>) { 
val r = Rectangle(3.0, 4.0, 0.0) 
printin(r.area()) 
r.onClick() 
} 
StH, this::class.simpleName Æ Kotlin 中 反射 的 API， 在 Gradle 工程 的 build.gradle 中 
需要 添加 依赖 compile: 


compile"org.jetbrains.kotlin:kotlin-reflect:$kotlin version" 


关于 反射 的 相关 内 容 ， 将 在 第 12 章 中 详细 介绍 。 

上 面 的 代码 运行 后 输出 如 下 : 

1250 

Rectangle is Clicked! 

当 子 类 继承 了 某 个 类 之 后 ， 便 可 以 使 用 父 类 中 的 成 员 变 量 ， 但 并 不 是 完全 继承 父 类 的 

所 有 成 员 变量 。 具 体 的 原则 如 下 : 

口 能 够 继承 父 类 的 public 和 protected 成 员 变量 ; 

O 不 能 继承 父 类 的 private 成 员 变量 ; 

口 对 于 父 类 的 包 访问 权限 成 员 变量 ， 如 果子 类 和 父 类 在 同一 个 包 下 ， 则 子 类 能 够 继 
承 ; 否则 ， 子 类 不 能 继承 ; 

口 对 于 子 类 可 以 继承 的 父 类 成 员 变量 ， 如 果 在 子 类 中 出 现 了 同名 称 的 成 员 变量 ， 则 
会 发 生 隐藏 现象 ， 即 子 类 的 成 员 变量 会 屏蔽 掉 父 类 的 同名 成 员 变 量 。 如 果 要 在 子 
类 中 访问 父 类 中 的 同名 成 员 变量 ， 需 要 使 用 super 关键 字 进 行 引用 。 


4.3.2 接口 


接口 是 一 种 比 抽象 类 更 加 抽象 的 “类 ”。 接 口 本 身 代 表 的 是 一 种 “类 型 ”的 概念 。 但 
在 语法 层面 ， 接 口 本 身 不 是 类 ， 不 能 实例 化 接口 ， 只 能 实例 化 它 的 实现 类 。 

接口 是 用 来 建立 类 与 类 之 间 的 协议 。 实 现 接口 的 实现 类 必须 要 实现 该 接口 的 所 有 方 
法 。 在 Java 8 和 Kotlin 中 ， 接 口 可 以 实现 一 些 通用 的 方法 。 

接口 是 抽象 类 的 延伸 ，Kotlin 与 Java 一 样 ， 不 支持 同时 继承 多 个 父 类 ， 也 就 是 说 继承 
只 能 存在 一 个 父 类 〈 单 继承 ) 。 但 是 接口 不 同 ， 一 个 类 可 以 同时 实现 多 个 接口 〈 多 组 合 ) ， 
无 论 这 些 接口 之 间 有 没有 关系 。 这 样 可 以 实现 多 重 继承 。 

和 Java 类 似 ，Kotlin 使 用 interface 作为 接口 的 关键 词 : 


interface ProjectService //Java 中 使 用 interface 声明 接口 


Kotlin 的 接口 与 Java 8 的 接口 类 似 。 与 抽象 类 相 比 ， 接 口 都 可 以 包含 抽象 的 方法 及 方 
法 的 实现 : 


interface ProjectService { 
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val name: String 
val owner: String 
fun save(project: Project) 
fun print() { 
println("I am project") 
} 
} 


接口 是 没有 构造 函数 的 。 我 们 使 用 冒号 “:” 语 法 来 实现 一 个 接口 ， 如 果 有 多 个 接口 ， 
AA“, ” ASRR: 


class ProjectServiceImpl : ProjectService // 与 继承 抽象 类 语法 一 样 ， 使 用 冒号 


class ProjectMilestoneServiceImpl : ProjectService, MilestoneService 


// 实 现 多 个 接口 使 用 逗号 “，” 隔 开 


EES print0 函 数 时 ,因为 我 们 实现 的 ProjectService, MilestoneService 都 有 一 个 print() 
函数 ， 当 直接 使 用 superprintO 函 数 时 ， 编 译 器 无 法 知道 我 们 想 要 调用 的 是 哪个 print 函数 ， 
我 们 把 这 种 现象 叫做 覆盖 冲突 ， 如 图 4-9 所 示 。 


oid 59 o override fun print() { 
orld) 2 = super.print() 


zuna” Deniact@ariiean cin 


Many supertypes available, please specify the one you mean in angle brackets, e.g. ‘super<Foo>* | 
ner = 
ka 


图 4-9 覆盖 冲突 
这 个 时 候 ， 我 们 可 以 使 用 下 面 的 语法 来 调用 : 


super<ProjectService>.print() // 使 用 super<ProjectService> 指定 调用 的 是 


ProjectService 接口 中 的 print () 函数 
super<MilestoneService>.print () // 使 用 super<MilestoneService> 来 指定 


调用 的 是 Mi lestoneService 接口 中 的 print () 
函数 


44 object WR 


单 例 模式 是 一 种 常用 的 软件 设计 模式 。 例 如 ，Spring 中 的 Bean 默认 就 是 单 例 。 通 过 单 
例 模式 可 以 保证 系统 中 一 个 类 只 有 一 个 实例 。 即 一 个 类 只 有 一 个 对 象 实例 。 
Kotlin 中 没有 静态 属性 和 方法 , 但 是 可 以 使 用 关键 字 object 声明 一 个 object 单 例 对 象 : 


package com.easy.kotlin 


object User { // 声 明 对 象 类 型 User 
val username: String = "admin" 
val password: String = "admin" 
fun hello() { 
println("Hello, object !") 
} 
} 


fun main(args: Array<String>) { 
println (User.username) //5 Java 静态 类 的 调用 形式 一 样 
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println (User.password) 


User.hello() //5 Java 静态 方法 的 调用 方式 一 样 


Kotlin 中 还 提供 了 伴生 对 象 ， 用 companion object 关键 字 声 明 : 


class DataProcessor { 
companion object DataProcessor { // 使 用 companion object Fal DataProcessor 


的 伴生 对 象 
fun process() { 
println("I am processing data ...") 
} 
} 
D 
fun main(args: Array<String>) { 
DataProcessor.process() //I am processing data ... 


ji 
一 个 类 只 能 有 一 个 伴生 对 象 。 


45 数 据 类 


顾名思义 ， 数 据 类 就 是 只 存储 数据 ， 不 包含 操作 行为 的 类 。Kotlin 中 的 数据 类 可 以 为 


我 们 节省 大 量 的 样板 代码 〈Java 中 强制 我 们 要 去 写 一 堆 getter, setter 代码 ， 而 实际 上 这 些 
方法 都 是 “不 言 自 明 ” 的 ) ， 这 样 最 终 的 代码 更 易于 理解 ， 便 于 维护 。 


4.5.1 创建 数据 类 


使 用 关键 字 为 data class 创建 一 个 只 包含 数据 的 类 : 


data class LoginUser(val username: String, val password: String) 


在 IDEA 中 提供 了 方便 的 Kotlin 工具 箱 ， 我 们 可 以 把 上 面 的 代码 反 编译 成 等 价 的 Java 


代码 。 步 又 如 下 : 


(1) 选择 菜单 栏 中 的 Tools|Kotlin|Show Kotlin Bytecode 命令 ， 如 图 4-10 所 示 。 
Code Analyze Refactor Build Run VCS Window Hep DOOF © eg Bes 108108 w— 2: 
—o 一 一 区 人 


4-10 选择 菜单 栏 中 的 Show Kotlin Bytecode 命令 
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(2) 在 弹出 的 对 话 框 中 单 击 Decompile 按钮 ， 如 图 4-11 所 示 。 


Kotlin Bytecode $- 


| Decompile | Inline Optimization Assertions 


a Hi com/easy/kotlin/LoginUser.class we 
2 |// class version 50.0 (50) 

3 |// access flags 0x31 

4 public final class com/easy/kotLin/LoginUser { 

5 

6 

7 // access flags 0x12 

8 private final Ljava/lang/String; username 

9 @org/jetbrains/annotations/NotNull;() // invisible 
10 

11 // access flags 0x11 

12 public final getUsername()Ljava/lang/String; 

13 @org/jetbrains/annotations/NotNull;() // invisible 
14 Lo 

15 LINENUMBER 3 LO 

16 ALOAD 9 

17 GETFIELD com/easy/kotlin/LoginUser.username : Ljava 
18 ARETURN 

19 u 

20 LOCALVARIABLE this Lcom/easy/kotlin/LoginUser; LO L 
21 MAXSTACK = 1 

22 MAXLOCALS = 1 


图 4-11 单 击 反 编译 按钮 


G) 反 编 译 之 后 的 Java 代码 ， 如 图 4-12 所 示 。 


P_ObjectDemokt ~ fE OataClassDemokt = gh DataClassDemo.decompiled.java 


Fa public final class LoginUser { 9 
15 @NotNull 

16 private final String username; 

17 @NotNull 

18 private final String password; 

19 

20 @NotNull 

21 @ = public final String getUsername() { return this.username; } 

24 

25 @NotNull 

26 @ = public final String getPassword() { return this.password; } 

29 

30 public LoginUser(@NotNull String username, @NotNull String password) { 
31 Intrinsics.checkParameterIsNotNull(username, paramName: “ysername"); 
32 Intrinsics.checkParameterIsNotNull (password, paramName “password"); 
33 super(); 

34 this.username = username; 

35 ‘this.password = password; 

36 } 

37 

38 @NotNull 

39 @ > public final String component1() { return this.username; } 

42 
143 NotNutL 

4 @ = public final String component2() { return this.password; } 

47 

48 @NotNull 

49 public final LoginUser copy(@NotNull String username, @NotNull String password) 
50 Intrinsics.checkParameterIsNotNull (username, paramName: "username" ); 
51 Intrinsics.checkParameterIsNotNull (password, paramName: "password"); 
52 return new LoginUser(username, password); 


4-12 反 编 译 之 后 的 Java 代码 


上 面 这 段 代码 反 编译 之 后 ， 完 整 的 Java 代码 如 下 : 


public final class LoginUser { 
@NotNull 
private final String username; 
@NotNull 
private final String password; 


@NotNull 
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public final String getUsername() { 
return this.username; 


} 


@NotNull 
public final String getPassword() { 
return this.password; 


} 


public LoginUser(@NotNull String username, @NotNull String password) { 
// 构 造 函数 
Intrinsics.checkParameterIsNotNull (username, "username") ; 
Intrinsics.checkParameterIsNotNull (password, "password"); 
super (); 
this.username = username; 
this.password = password; 


} 
@NotNull 
public final String component1() { //component1() 函数 ， 返 回 第 1 个 成 员 值 
username 
return this.username; 
} 
@NotNull 
public final String component2() { //component2() 函数 ， 返 回 第 2 个 成 员 值 
password 
return this.password; 
} 
@NotNull 


public final LoginUser copy(@NotNull String username, @NotNull String 
password) { 
Intrinsics.checkParameterIsNotNull (username, "username") ; 
Intrinsics.checkParameterIsNotNull (password, "password") ; 
return new LoginUser(username, password) ; 


} 


@NotNull 
public static LoginUser copy$default (LoginUser var0, String varl, String 
var2, int var3, Object var4) { 
if ((var3 & 1) != 0) { 
varl = var0.username; 


} 


if ((var3 é 2) != 0) { 
var2 = var0.password; 


} 


return var0.copy (varl, var2); 


public String toString() { 
return "LoginUser (username=" + this-.username + ", password=" + this. 
password + ")"; 


public int hashCode() { 
return (this.username != null ? this.username.hashCode() : 0) * 31 + 


(this.password != null ? this.password.hashCode() : 0); 
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public boolean equals (Object varl) { 
3f (this != vari) E 
if (varl instanceof LoginUser) { 
LoginUser var2 (LoginUser) varl; 
if (Intrinsics.areEqual(this.username, var2.username) && 
Intrinsics.areEqual (this.password, var2.password)) { 
return true; 


} 


return false; 
} else { 
return true; 
} 
P 
i 


45.2 ”数据 类 自动 创建 的 函数 


编译 器 会 根据 主 构造 函数 中 声明 的 属性 ， 自 动 创建 以 下 3 个 函数 。 

口 equals()/hashCode() 函数 toString() RR st AW "LoginUser(username="+this.username+", 
password="+this.password+")"; 

O component! ()#il component20) 函 数 返 回 对 应 下 标的 属性 值 ， 按 声明 顺序 排列 ; 

O copy0 函 数 :根据 旧 对 象 属性 重新 newLoginUser(usermame,password) 一 个 对 象 出 来 。 

如 果 这 些 函 数 在 类 中 已 经 被 明确 定义 了 , 或 者 从 超 类 中 继承 而 来 , 编译 器 就 不 再 生成 。 


45.3 数据 类 的 语法 限制 


数据 类 有 如 下 限制 : 

D 主 构 造 函 数 至 少 包含 一 个 参数 ; 

口 参数 必须 标识 为 val 或 者 var; 

口 不 能 为 abstract、open、sealed 或 者 inner; 
O 不 能 继承 其 他 类 (但 可 以 实现 接口 )。 
另外 ， 数 据 类 可 以 在 解构 声明 中 使 用 : 


package com.easy.kotlin 
data class LoginUser(val username: String, val password: String) 


fun main(args: Array<String>) { 
val loginUser = LoginUser("admin", "admin") 
val (username, password) = loginUser // 解 构 声明 (username, password) 
println ("username = ${username}, password = ${password}") //username = 
admin, password = admin 


4.5.4 Pair 和 Triple 


Kotlin 标准 库 提 供 了 Pair 和 Triple 数据 类 ， 分 别 表示 二 元 组 和 三 元 组 对 象 。 它 们 的 定 
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义 分 别 如 下 : 
public data class Pair<out A, out B>( 
public val first: A, 
public val second: B) : Serializable { 
public override fun toString(): String = "($first, $second)" 
} 
public infix fun <A, B> A.to(that: B): Pair<A, B> = Pair(this, that) 


// PRB to () 


public data class Triple<out A, out B, out C>( 
public val first: A, 
public val second: B, 
public val third: C) : Serializable { 
public override fun toString(): String = "($first, $second, $third)" 
} 


我 们 可 以 使 用 Pair 对 象 来 初始 化 一 个 Map， 代 码 示例 如 下 : 


>>> val map = mapO£(1 Eo "A", 2 to BY 3° to Ch 
>>> map 
{1=A, 2=B, 3=C} 


46 注 解 


注解 是 将 元 数据 附加 到 代码 中 。 元 数据 信息 由 注解 kotlin.Metadata 定义 。 


@Retention (AnnotationRetention.RUNTIME) 
@Target (AnnotationTarget.CLASS) 
internal annotation class Metadata 


这 个 @Metadata 信息 存在 于 由 Kotlin 编译 器 生成 的 所 有 类 文件 中 ， 并 由 编译 器 和 反射 
读 取 。 例 如 ， 使 用 Kotlin 声明 一 个 注解 的 代码 如 下 : 


annotation class Suspendable 


Kotlin 中 使 用 关键 字 annotation class 来 声明 注解 。 
对 应 的 Java 代码 如 下 : 


@interface Suspendable 


Kotlin 编译 器 会 为 注解 生成 对 应 的 元 数据 信息 : 


@Retention (RetentionPolicy.RUNTIME) 
@Metadata( 
my = tl ae ie 
bv = {1, 0, 2}, 
Eet 
dl = {"\u0000\n\n\u0002\u0018\u0002\n\u0002\u0010\u001b\n\u0000\b\ 
u0086\u0002\u0018\u00002\u00020\u0001B\u0000"\u0006\u0002"}, 
d2 = {"Lcom/easy/kotlin/Suspendable;", "", "production sources for module 
kotlin tutorials_main"} 
) 
public @interface Suspendable { 
j: 
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Kotlin 的 注解 完全 兼容 Java 的 注解 。 例如， 在 Kotlin 中 使 用 Spring Data JPA 的 代码 示 
例如 下 : 


interface ImageRepository : PagingAndSortingRepository<Image, Long> { 


@Query(""" 

SELECT a from #{#entityName} a 

where a.isDeleted=0 

and a.isFavorite=1 

and a.category like %:searchText% 

order by a.gmtModified desc 

Sua) //(1) @Query 注解 中 value 是 一 个 JPQL 字符 串 

fun searchFavorite (@Param("searchText") searchText: String, pageable: 
Pageable) : 

Page<Image> // (2) 声明 一 个 查询 接口 ， 返 回 分 页 结果 


@Throws (Exception::class) 

@Modifying //JPA 的 保存 /更 新 操作 需要 加 上 这 个 aeModi fying 注解 , 表示 这 是 一 个 修改 操作 
@Transactional //JPA 的 保存 /更 新 操作 需要 加 上 这 个 6Transactional 注解 ， 表 示 需 要 事务 
@Query ("update #{#entityName} a set a.isFavorite=1,a.gmtModified=now () 
where a.id=?1") 

fun addFavorite (id: Long) 

$ 


代码 说 明 如 下 : 

O Kotlin 中 使 用 IPA 的 @Query 注解 ， 括 号 里 面 的 参数 是 JPQL 语句 ， 我 们 使 用 3 个 
双 引 号 括 起 来 ， 与 Python 中 的 语法 一 样 。 

口 使 用 @Param("searchText") 注 解 来 指定 命名 参数 ， 在 JPQL 中 使 用 searchText 语法 
来 使 用 这 个 参数 。 

可 以 看 出 ，Kotlin 使 用 Java 生态 库 中 的 注解 ， 用 起 来 与 Java 的 注解 基本 一 样 。 

下 面 再 举 一 个 Kotlin 使 用 SpringMVC 注解 的 代码 例子 。 


@Controller // (1) Kotlin 代码 中 直接 使 用 econtroller 注解 
class MeituController { 
@Autowired //(2) Kotlin 代码 中 直接 使 用 @ Autowired 注解 


lateinit var imageRepository: ImageRepository 
// (3) 延迟 初始 化 imageRepository Bean 
//(4) Kotlin 代码 中 直接 使 用 CRequestMapping 注解 ， 需 要 注意 这 里 关于 value, 


method 数组 的 语法 与 Java 不 同 
@RequestMapping (value = ["/", "meituView"], method = [RequestMethod.GET]) 
fun meituView (model: Model, request: HttpServletRequest) : ModelAndView { 
model ["requestURI"] = request.requestURI // (5) 
return ModelAndView ("meituView") 


i 


代码 说 明 如 下 : 

口 第 (1) 处 使 用 SpringMVC 的 @Controller 注解 ; 

口 第 (2) 处 使 用 Spring 的 @Autowired 注解 装配 Bean; 

O 第 G) 处 延迟 初始 化 Bean〈 等 用 到 该 Bean 的 时 候 才 去 创建 对 象 ) ; 

O 第 (4) 处 使 用 SpringMVC 的 @RequestMapping Èf, H}, value 与 method 的 值 
是 数组 ， 中 括号 [] 的 语法 是 Kotlin1.2 中 引入 的 特性 。 在 这 之 前 ， 我 们 需要 使 用 
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value=*arrayOf("/", "meituView") 这 样 的 语法 。 这 个 新 语法 特性 背后 的 实现 是 inline 
函数 ， 对 应 的 实现 代码 如 下 : 


public inline fun <reified @PureReifiable T> arrayOf(vararg elements: T): 
Array<T> 


其 中 ，reified 是 具体 化 类 型 关键 字 ，@PureReifiable 注解 用 来 指定 对 应 的 类 型 参数 不 
能 用 于 不 安全 操作 , 如 强制 转换 或 is 检查 。 这 意味 着 使 用 泛 型 类 型 作为 参数 是 完全 安全 的 。 
关于 泛 型 将 在 第 8 章 中 介绍 。 

从 上 面 的 例子 可 以 看 出 ， 在 Kotlin 中 使 用 Java 框架 非常 简便 。 
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Kotlin 中 使 用 enum class 关键 字 来 声明 一 个 枚 举 类 。 例 如 : 


enum class Direction { // 使 用 enum class 声明 一 个 Direction 枚 举 类 型 
NORTH, SOUTH, WEST, EAST // 每 个 枚 举 常 量 都 是 一 个 对 象 ， 用 逗号 分 隔 
相 比 于 字符 串 常量 ， 使 用 枚 举 能 够 实现 类 型 安全 。 枚 举 类 有 两 个 内 置 的 属性 : 


public final val name: String 
public final val ordinal: Int 


分 别 表示 的 是 枚 举 对 象 的 值 与 下 标 位 置 。 例 如 上 面 的 Direction 枚 举 类 ， 它 的 枚 举 对 象 的 信 
息 如 下 : 


>>> val north = Direction.NORTH // 访 问 枚 举 中 的 NORTH 对 象 


>>> north.name //name 属性 

NORTH 

>>> north.ordinal //ordinal 属性 

0 

>>> north is Direction //north 的 类 型 是 Direction 
true 


每 一 个 枚 举 都 是 枚 举 类 的 实例 ， 它 们 可 以 被 初始 化 : 


enum class Color(val rgb: Int) { // 声 明 一 个 带 构造 参数 rgb : Int 的 枚 举 类 
Color(val rgb: Int) 


RED (0xFF0000), //rgb = 0xFF0000 
GREEN (0x00FF00), //rgb = 0x00FF00 
BLUE (0x0000FF) //rgb = 0x0000FF 
` 
BE Color 的 枚 举 对 象 信息 如 下 : 
>>> val c = Color.GREEN // 访 问 Color 枚 举 类 型 中 的 GREEN 元 素 
ee. 
GREEN 
>>> c.rgb // 访 问 GREEN 枚 举 的 rgb 参数 值 
65280 
>>> c.ordinal // 访 问 GREEN BEE ordinal 属性 
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1 
>>> c.name //GREEN 枚 举 的 name 属性 
GREEN 
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48 A 部 类 


本 节 我 们 介绍 Kotlin 的 内 部 类 ， 包 括 普通 嵌 套 类 、 内 部 嵌 套 类 和 匿名 内 部 类 。 


4.8.1 imme 


Kotlin 中 ， 类 可 以 嵌 套 。 一 个 类 可 以 嵌 套 在 其 他 类 中 ， 而 且 可 以 嵌 套 多 层 。 


class NestedClassesDemo { 
class Outer { 
private val zero: Int = 0 
val one: Int = 1 


class Nested { 
fun getTwo() = 2 
class Nestedl1 { 
val three = 3 
fun getFour() = 4 


8 
测试 代码 如 下 : 


val one = NestedClassesDemo.Outer().one 

val two = NestedClassesDemo.Outer.Nested() .getTwo () 

val three = NestedClassesDemo.Outer.Nested.Nested1().three 
val four = NestedClassesDemo.Outer.Nested.Nestedl () .getFour () 


可 以 看 出 ， 代 码 中 NestedClassesDemo.Outer.Nested().getTwo() Ù H Zb AREA 
接 使 用 类 名 .来 访问 ， 有 多 少 层 嵌 套 ， 就 用 多 少 层 类 名 来 访问 。 
普通 嵌 套 类 没有 持 有 外 部 类 的 引用 ， 所 以 是 无 法 访问 外 部 类 变量 的 : 


class NestedClassesDemo { 

class Outer { 
private val zero: Int = 0 
val one: Int = 1 


class Nested { 
fun getTwo() = 2 
fun accessOuter() = { 
println (zero) // 报 错 : cannot access outer class 


println (one) // 报 错 : cannot access outer class 
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48.2 REAR 


如 果 一 个 类 Inner 想 要 访问 外 部 类 Outer 中 的 成 员 ， 可 以 在 这 个 类 前 面 添加 修饰 符 
inner。 内 部 类 会 带 有 一 个 对 外 部 类 的 对 象 引 用 。 


package com.easy.kotlin 


class NestedClassesDemo { 
class Outer { 
private val zero: Int = 0 
val one: Int = 1 


inner class Inner { // 使 用 Inner 关键 字 声 明 内 部 类 


fun accessOuter() = { 
println (zero) //works 
println (one) //works 


} 


i 


fun main (args: Array<String>) { 
val innerClass = NestedClassesDemo.Outer().Inner() .accessOuter () 


j 


可 以 看 到 ， 当 访问 innerclassInner 的 时 候 ， 我 们 使 用 的 是 Outer0.Inner()， 这 是 持 有 了 
Outer 的 对 象 引用 ， 与 普通 嵌 套 类 直接 使 用 类 名 访问 的 方式 不 同 。 
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匿名 内 部 类 就 是 没有 名 字 的 内 部 类 。 匿 名 内 部 类 也 可 以 访问 外 部 类 的 变量 。 下 面 使 用 
对 象 表达 式 创建 一 个 匿名 内 部 类 实例 : 


class NestedClassesDemo { 
class AnonymousInnerClassDemo { 
var isRunning = false 
fun doRun() { 


Thread(object : Runnable {  // 匿 名 内 部 类 
override fun run() { 
isRunning = true 
println("doRun : i am running, isRunning = $isRunning") 


} 
}) -start () 


i 


如 果 对 象 是 函数 式 Java 接口 ， 即 具有 单个 抽象 方法 的 Java 接口 的 实例 ， 例 如 上 面 例 
子 中 的 Runnable 接口 : 


@FunctionalInterface //Java 8 中 引入 的 函数 式 接口 注解 


public interface Runnable { 


public abstract void run(); // 函 数 式 接口 只 有 一 个 方法 
} 
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我 们 可 以 使 用 Lambda 表达 式 实现 Runnable 接口 。 下 面 的 几 种 写法 都 是 可 以 的 : 


fun doStop() { 
var isRunning = true 
Thread ({ // 直 接 使 用 Lambda 表达 式 
isRunning = false 
println("doStop: i am not running, isRunning = $isRunning") 
}) «start () 
} 


fun doWait() { 
var isRunning = true 
val wait = Runnable { // 使 用 匿名 内 部 类 的 方式 ， 使 用 Lambda 表达 式 实现 run 接口 
isRunning = false 
println("doWait: i am waiting, isRunning = $isRunning") 
} 
Thread (wait) .start () 
} 


fun doNotify() { 
var isRunning = true 


val wait = { // 直 接 声明 一 个 Lambda 函数 
isRunning = false 
println("doNotify: i notify, isRunning = $isRunning") 


} 
Thread (wait) .start () 
} 


更 多 关于 Lambda 表达 式 及 函数 式 编程 的 相关 内 容 ， 将 在 第 5 章 中 介绍 。 
49 本 章 小 结 


本 章 我 们 介绍 了 Kotlin 面向 对 象 编程 的 特性 : 类 与 构造 函数 、 抽 象 类 与 接口 、 继 承 与 


组 合 等 知识 ， 同 时 介绍 了 Kotlin 中 的 注解 类 、 枚 举 类 、 数 据 类 、 媒 套 类 、 内 部 类 、 匿 名 内 
部 类 、 单 例 object 对 象 等 特性 类 。 


总 的 来 说 ， 在 面向 对 象 编程 范式 的 支持 上 ，Kotlin 相 比 于 Java， 增 加 了 不 少 有 趣 的 功 


能 与 特性 支持 ， 这 使 得 写 起 代码 来 更 加 方便 、 快 捷 了 。 


我 们 知道 , 在 Java 8 中 , 引进 了 对 函数 式 编程 的 支持 : Lambda 表达 式 、Function 接口 、 


streamAPI 等 ， 而 在 Kotlin 中 ， 对 函数 式 编程 的 支持 更 加 全 面 、 丰 富 ， 代 码 写 起 来 也 更 加 
简单 、“ 优 雅 ”。 第 5 章 中 将 一 起 学 习 Kotlin 的 函数 式 编程 。 


本 章 代码 示例 工程 : https://github.com/EasyKotlin/kotlin_tutorials。 
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凡 此 变数 中 含 彼 变数 者 ， 则 此 为 彼 之 函数 。 ( 李 善 兰 《 代 数学 》) 

函数 式 编程 语言 最 重要 的 基础 是 入 演算 (lambdacalculus)， 而 且 入 演算 的 函数 可 以 传 
入 函数 参数 ,也 可 以 返回 一 个 函数 。 函 数 式 编程 (简称 FP) 是 一 种 编程 范式 (programming 
paradigm) 。 

函数 式 编程 与 命令 式 编程 最 大 的 不 同 是 : 函数 式 编程 的 焦点 在 于 数据 的 映射 ， 命 令 式 
编程 (imperative programming) 的 焦点 是 解决 问题 的 步 又。 函数 式 编程 不 仅仅 指 的 是 Lisp、 
Haskell, Scala 等 类 的 语言 ， 更 重要 的 是 一 种 编程 思维 ， 解 决 问题 的 思考 方式 ， 也 称 面 向 函 
数 编程 。 

函数 式 编程 的 本 质 是 函数 的 组 合 。 例 如 ， 想 要 过 滤 出 一 个 List 中 的 奇数 ， 用 Kotlin 代 
码 可 以 这 样 写 : 

package com.easy.kotlin 


fun main(args: Array<String>) { 
val Tist = istoc A, 37 te Gi 6 T) 
println(list.filter { it % 2 == 1 }) // 过 滤 函 数 ， 参 数 是 一 个 Lambda 表达 式 


这 个 映射 的 过 程 可 以 使 用 图 5-1 来 形象 地 说 明 。 


0000000 


filter 函数 {it%2==1} 


lo © © © 


图 5-1 filter 函数 的 映射 过 程 
而 同样 的 逻辑 使 用 命令 式 的 思维 方式 来 写 的 话 ， 代 码 如 下 : 
package com.easy.kotlin; 
import java.util.ArrayList; 
import java.util.Arrays; 


import java.util.List; 


import static java.lang.System.out; 
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public class FilterOddsDemo { 
public static void main(String[] args) { 
List<Integer> list = Arrays.asList (new Integer[] {1, 2, 3, 4, 5, 6, 7})7 
//Java 中 初始 化 List 
out.println(filterOdds(list)); // 输 出 : [1, 3, 5, 7] 
} 


public static List<Integer> filterOdds(List<Integer> list) { 
// 使 用 命令 式 编程 思维 实现 过 滤 函 数 

List<Integer> result = new ArrayList (); 
for (Integer i : list) { 

if (isOdd(i)) { 

result.add(i); 

} 
} 
return result; 


} 


private static boolean isOdd(Integer i) {  // 判 断 是 否 是 奇数 的 函数 
return i % 2 != 0; 
} 
$ 
可 以 看 出 ， 函 数 式 编程 是 简单 、 自 然 、 直 观 易 懂 且 美丽 、“ 优 雅 ” 的 编程 风格 。 函 数 
式 编程 语言 中 通常 都 会 提供 常用 的 map, reduce, filter 等 基本 函数 ， 这 些 函 数 是 对 List, 
Map 集合 等 基本 数据 结构 的 常用 操作 的 高 层次 封装 ， 就 像 一 个 更 加 智能 、 好 用 的 工具 箱 。 


51 函数 式 编程 简介 


函数 式 编程 是 关于 不 变性 和 函数 组 合 的 编程 范式 。 函 数 式 编程 有 如 下 特征 。 

O 一 等 函数 支持 (first-class function) : 函数 也 是 一 种 数据 类 型 ， 可 以 作为 参数 传 入 
另 一 个 函数 中 ， 同 时 函数 也 可 以 返回 一 个 函数 。 

O 纯 函 数 (pure function) 和 不 变性 Cimmutable) : 纯 函 数 指 的 是 没有 副作用 的 函数 
〈 函 数 不 去 改变 外 部 的 数据 状态 ) 。 例 如 ， 一 个 编译 器 就 是 一 个 广义 上 的 纯 函 数 。 
在 函数 式 编程 中 ， 倾 向 于 使 用 纯 函 数 编程 。 正 因为 纯 函 数 不 会 去 修改 数据 ， 同 时 
又 使 用 不 可 变 的 数据 ， 所 以 程序 不 会 去 修改 一 个 已 经 存在 的 数据 结构 ， 而 是 根据 
一 定 的 映射 逻辑 创建 一 份 新 的 数据 。 函 数 式 编程 是 转换 数据 而 非 修改 原始 数据 。 

口 函数 的 组 合 (compose function) : 在 面向 对 象 编程 中 是 通过 对 象 之 间 发 送 消息 来 
构建 程序 逻辑 的 ， 而 在 函数 式 编程 中 是 通过 不 同 函数 的 组 合 来 构建 程序 逻辑 的 。 


52 声明 函数 


Kotlin 中 使 用 fun 关键 字 来 声明 函数 ， 其 语法 实例 如 图 5-2 所 示 。 
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man 函数 名 BUASIR ”函数 的 返回 类 型 
的 关键 字 | 


fun multiply(x: Int, y: Int): Int 
A D 函数 体 


return x * y 
1) 


图 5-2 声明 函数 语法 


为 了 更 加 直观 地 表现 函数 也 可 以 当 作 变 量 来 使 用 ,声明 一 个 函数 类 型 的 变量 sum 如 下 : 


>>> val sum = fun(x:Int, y:Int):Int { return x + y } 


// sum 的 类 型 是 一 个 函数 类 型 的 变量 
>>> sum 


(kotlin.Int，kotlin.Int) -> kotlin.Int //sum 是 输入 参数 是 2 个 Int、 输 出 类 
型 是 Int 的 函数 


可 以 看 到 这 个 函数 变量 sum 的 类 型 是 : 

(kotlin.Int, kotlin.Int) -> kotlin.Int 
这 个 带 箭头 “->” 的 表达 式 就 是 一 个 函数 类 型 ， 表 示 一 个 输入 两 个 Int 类 型 值 、 输 出 一 个 
Int 类 型 值 的 函数 。 可 以 直接 使 用 这 个 函数 字面 值 sum: 


>>> sum(1,1) // 直 接 使 用 sum 这 个 函数 字面 值 来 调用 函数 
2 


从 上 面 这 个 典型 的 例子 中 可 以 看 出 ，Kotlin 也 是 一 种 面向 表达 式 的 语言 。 既 然 sum 是 
一 个 代表 函数 类 型 的 变量 ， 稍 后 我 们 将 看 到 一 个 函数 可 以 当 作 参数 传 入 另 一 个 函数 中 高 
MERO o 


当然 ， 我 们 仍然 可 以 像 C、C++、Java 语言 一 样 ， 直 接 带 上 函数 名 来 声明 一 个 函数 : 
fun multiply(x: Int, y: Int): Int { //fun 关键 字 加 上 函数 名 multiply 声明 函数 


return x * y 


} 


multiply(2, 2) //4 


53 Lambda 表达 式 


在 本 章 开头 部 分 讲 到 了 下 面 这 段 代码 : 


EEN 
TS 
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这 里 的 filter0 函 数 的 入 参 {it%2 一 1} 就 是 一 段 Lambda 表达 式 。 实 际 上 ， 因 为 filter() 函 
数 只 有 一 个 参数 ， 所 有 括号 被 省 略 了 。 所 以 ，filter0 函 数 调用 的 完整 写法 是 : 


list.filter ({ it % 2 = 1 }) 


其 中 的 filter0 函 数 声明 如 下 : 
public inline fun <T> Iterable<T>.filter (predicate: (T) -> Boolean) : List<T> 
//filter () 函 数 签名 
其 实 ，filter0 函 数 的 入 参 是 一 个 函数 predicate: (T) -> Boolean。 实 际 上 
{ it 32==1} //%8 565 Lambda 表达 式 
是 一 种 简写 的 语法 ， 完 整 的 Lambda 表达 式 是 这 样 写 的 : 
{ he => ae 2 a // 实 际 的 Lambda 表达 式 


如 果 拆 开 来 写 ， 就 更 加 容易 理解 : 


>>> val isOdd = { it: Int -> it % 2 = 1 } 
// 直 接 使 用 Lambda 表达 式 声明 一 个 函数 ， 这 个 函数 判断 输入 的 Int 是 不 是 奇数 


>>> isOdd 
(kotlin.Int) -> kotlin.Boolean //isOdd 函数 的 类 型 
>>> vali lise — Tiston 2.13) 4) 5) 6) 7) 
>>> list. filter (isOdd) // 直 接 传 入 isodd 函数 
(1, 3, 5, 7] 

54 高 阶 函 数 
本 节 介绍 Kotlin 中 的 高 阶 函数 。 


其 实在 上 面 的 代码 示例 list.filter(isOdqd) 中 ， 已 经 看 到 了 高 阶 函数 。 现 在 再 添加 一 层 映 
射 逻辑 。 我 们 有 一 个 字符 串 列 表 : 


val strList = listOf("a", "ab", "abc", "abcd", "abcde", "abcdef", "abcdefg") 


然后 我 们 想 要 过 滤 出 字符 串 元 素 的 长 度 是 奇数 的 列表 。 我 们 把 这 个 问题 的 解决 逻辑 拆 
成 两 个 函数 来 组 合 实现 : 

wak a a | ence Casse al // 判 断 输入 的 Int 是 否 奇数 

val g = fun (s: String) = s.length // 返 回 输 入 的 字符 串 参数 的 长 度 

我 们 再 使 用 函数 h 来 封装 “字符 串 元 素 的 长 度 是 奇数 ”这 个 逻辑 ， 实 现代 码 如 下 : 

val h = fun(g: (String) -> Int, f: (Int) -> Boolean): (String) -> Boolean { 

y return { f(g(it)) } 

但 是 这 个 h 函数 的 声明 有 些 长 了 ， 尤 其 是 3 个 函数 类 型 声明 的 箭头 表达 式 ， 显 得 不 够 
简洁 。 不 过 不 用 担心 ，Kotlin 中 有 简单 好 用 的 Kotlin 类 型 别名 ， 我 们 使 用 G. F, HREH 
3 个 函数 类 型 


DKG 
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typealias G = (String) -> Int 
typealias F = (Int) -> Boolean 
typealias H = (String) -> Boolean 


那么 ， 我 们 的 h 函数 就 可 以 写成 下 面 这 样 了 : 
val h = fun(g: G, f: F): H { 


return { f(g(it)) } // 需 要 注意 的 是 ， 这 里 的 {} 是 不 能 省 略 的 
} 


这 个 h 函数 的 映射 关系 可 用 图 5-3 来 说 明 。 


h=f(g(s)) 


g(s) 一 一 一 x:Int £(x) —— 


图 5-3 复合 函数 h 的 映射 关系 


在 函数 体 的 代码 retum{ fgGib)} 中 ， 全 代表 这 是 一 个 Lambda 表达 式 ， 返 回 的 是 一 个 
(String)->Boolean 函数 类 型 。 如 果 没 有 {}， 那 么 返回 值 就 是 一 个 布尔 类 型 Boolean 了 。 

通过 上 面 的 代码 例子 可 以 看 到 ， 在 Kotlin 中 ， 我 们 可 以 简单 地 实现 高 阶 函 数 。 现 在 逻 
辑 已 经 实现 完成 ， 下 面 我 们 在 main0 函 数 中 运行 测试 一 下 效果 。 


fun main(args: Array<String>) { 
val strList = listOf("a", "ab", "abc", "abcd", "abcde", "abcdef", "abcdefg") 
println(strList.filter(h(g, f))) // 输 出 : [a, abc, abcde, abcdefg] 

} 


当 你 看 到 h(g,f) 这 样 的 复合 函数 的 代码 时 一 定 很 开心 ， 感 到 很 自然 ， 这 与 数学 公式 很 
贴近 ， 简 单 易 懂 。 


5.5 Kotlin 中 的 特殊 函数 


本 节 我 们 介绍 Kotlin 中 的 run(), apply(), e), also) withO 这 5 个 特殊 的 函数 。 本 
节 代 码 示例 中 用 到 的 测试 函数 myfun0 代 码 如 下 : 


fun myfun(): String { 
println ("执行 了 myfun 函数 ") 
return "这 是 myfun 的 返回 值 " 
} 


5.5.1 run() 函 数 


run0) 函 数 的 定义 如 下 : 


public inline fun <R> run(block: () -> R): R { 
contract { 
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callsInPlace (block, InvocationKind.EXACTLY ONCE) 


} 
return block() 


i 


我 们 重点 看 最 后 一 行 代码 block0， 其 实 就 是 调用 传 入 的 block 参数 ， 一 般 情 况 下 是 一 
个 Lambda 代码 块 。 测 试 代码 示例 如 下 : 


fun testRunFun() { 


myfun () // 直 接 在 代码 行 调 用 函数 
run({ myfun() }) // 使 用 run () 函数 调用 myfun () 函数 
run { myfun() } //run() 函数 的 括号 “() ”可 以 省 略 


run { println("A") } // 等 价 于 println ("A") 
} 


fun main(args: Array<String>) { 
testRunFun () 


运行 上 面 的 代码 ， 输 出 如 下 : 


执行 了 myfun 函数 
执行 了 myfun 函数 
执行 了 myfun 函数 
A 


5.5.2 apply() 函 数 


apply0 函 数 的 定义 如 下 : 


public inline fun <T> T.apply (block: T.() -> Unit): T { 
contract { 
callsInPlace (block, InvocationKind.EXACTLY ONCE) 
} 
block () 
return this 


} 


同样 ， 我 们 重点 看 最 后 两 行 代码 ， 先 是 调用 了 block0) 函 数 ， 然 后 返回 当前 的 调用 者 对 
象 this。 意 思 是 执行 完 block0 代 码 块 逻辑 后 ， 再 次 返回 当前 的 调用 者 对 象 。 测 试 代码 示例 
如 下 : 


fun testApply() { 
// 普 通 写 法 
val list = mutableListOf<String>() 
list.add("A") 
list.add("B") 
list.add("C") 


println ("485% list = $list") // 普 通 写 法 list = [A, B, C] 
println (list) 

// 使 用 apply () 函数 的 写法 

val a = ArrayList<String>() .apply { // 调 用 apply () 函数 


“Sle 
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add("A") 
add("B") 
add("C") 
println(" 使 用 apply 函数 写法 this = $this") 
} 
printin (a) 
// 等 价 于 
a.let { println(it) } 
} 


fun main(args: Array<String>) { 
testApply () 
} 


运行 上 面 的 代码 ， 输 出 如 下 


MASI list = [A, B, C] 

[A, B, C] 

使 用 apply 函数 写法 this = [A, B, C] 
[A, B, C] 

[A, B, C] 


55.3 let() 函 数 


let0 函 数 的 定义 如 下 : 


public inline fun <T, R> T.let(block: (T) -> R): RI 
contract { 
callsInPlace (block, InvocationKind.EXACTLY_ ONCE) 
} 
return block(this) 
} 


同样 ， 我 们 还 是 重点 看 最 后 一 行 代 码 block(this)， 意 思 是 把 当前 调用 对 象 作为 参数 传 
入 block0 代 码 块 中 。 测 试 代码 示例 如 下 : 


fun testLetFun() { 
1.let { println(it) } // 输 出 1， 其 中 it 就 是 调用 者 1 
"ABC". let { println(it) } // 输 出 ABC， 其 中 it 就 是 调用 者 ABC 
// 执 行 完 函数 myfun () ， 返 回 值 传 给 let () 函数 
myfun().let { 
print (it) 
} 
} 


fun main (args: Array<String>) { 
testLetFun () 
} 


运行 上 面 的 代码 ， 输 出 如 下 : 


ABC 
执行 了 myfun 函数 
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这 是 myfun 的 返回 值 
5.5.4 also() 函 数 


also0 函 数 的 定义 如 下 : 


public inline fun <T> T.also(block: (T) -> Unit): T { 


contract { 
callsInPlace (block, InvocationKind.EXACTLY ONCE) 


} 

block (this) 

return this 
} 


同样 ， 我 们 还 是 看 最 后 两 句 ， 首 先是 调用 了 block(this), A let0 函 数 的 逻辑 ， 但 是 
最 后 返回 的 值 是 this， 也 就 是 当前 的 调用 者 。 测 试 代码 示例 如 下 : 


fun testAlsoFun() { 
val a = "ABC".also { 
println(it) // 输 出 : ABC 
} 
println(a) // 输 出 : ABC 
a.let { 
println(it) // 输 出 : ABC 
} 
D 


fun main(args: Array<String>) { 
testAlsoFun () 
} 


5.5.5 with) žr 


with RAYE MHF: 


public inline fun <T, R> with(receiver: T, block: T.() -> R): R { 


contract { 
callsInPlace (block, InvocationKind.EXACTLY_ ONCE) 


} 
return receiver.block() 


i 


我 们 看 到 withO 函 数 传 入 了 一 个 接收 者 对 象 receiver， 然 后 使 用 该 对 象 receiver 去 调用 
传 入 的 Lambda 代码 块 receiverblock0。 测 试 代码 如 下 : 


fun testWithFun() { 
// 普 通 写法 
val list = mutableListOf<String>() 
list.add("A") 
list.add("B") 
list.add("C") 
println ("常规 写法 list = $list") // 常 规 写法 list = [A, B, C] 


// 使 用 with () 函数 写法 


with (ArrayList<String>()) { 
DER 
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add ("A") 
add ("B") 
add ("cC") 
println(" 使 用 with 函数 写法 this = $this") 
// 使 用 with () 函数 的 写法 this = [A, B, C] 
}.let { 
println (it) //kotlin.Unit 
} 
} 


fun main(args: Array<String>) { 


testWithFun () 
} 


56 本 章 小 结 


在 Kotlin 中 ， 支 持 函数 作为 “一 等 公民 ”， 它 支持 高 阶 函数 、Lambda 表达 式 等 。 我 
们 不 仅 可 以 把 函数 当 作 普 通 变 量 一 样 传递 、 返 回 ， 还 可 以 把 它 分 配给 变量 、 放 进 数据 结构 
或 者 进行 一 般 性 的 操作 。 在 Kotlin 中 进行 函数 式 编程 相当 简单 。 
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在 使 用 Java 的 时 候 ， 我 们 经 常 使 用 诸如 StingUtl、DateUtil 等 工具 类 ， 代 码 写 起 来 比较 元 
长 。 举 个 例子 ， 获 取 一 个 字符 串 的 第 一 个 字符 值 、 最 后 一 个 字符 值 。 如 果 我 们 用 Java 代码 来 写 
通常 是 要 先 声明 一 个 StingUtil 类 ， 然 后 在 里 面 写 相应 的 工具 方法 ， 代 码 可 以 是 下 面 这 样 : 

package com.easy.kotlin; 

import static java.lang.System.out; 

public class StringUtil { //Java 工具 类 StringUtil 的 代码 


Ven 
* 获取 str 的 第 一 个 字符 值 
+ 


* @param str 
* @return 
*/ 
public static String firstChar (String str) 
if (str != null && str.length() > 0) EN 
return str.charAt(0) + ""; // 获 取 第 1 个 字符 ， 转 为 String 返回 
} 
return ""; 
} 
Ven 


* 获取 str 的 最 后 一 个 字符 值 
* 


* @param str 
* @return 
*/ 
public static String lastChar (String Soe { 
if (str != null && str.length() > 0) 
return str.charAt (str. length () - ty AR -个 字符 ， 转 为 String 返回 
} 


return ""; 


public static void main(String[] args) { 


String str = "abc"; 
out.println (StringUtil.firstChar (str) ); // 返 回 a 
out.println (StringUtil.lastChar (str) ); // 返 回 c 


} 
我 们 可 以 看 到 StringUtil.firstChar(str) 这 样 的 调用 方式 不 够 简单 直接 。 能 不 能 直接 这 样 
调用 呢 ? 


Haben rnar( 
"abc".lastChar () 


非常 遗憾 的 是 ， 在 Java 中 我 们 无 法 给 Suing 类 添加 一 个 自 定义 方法 。 因 为 String 类 是 
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JDK 中 内 置 的 基础 类 ， 而 且 为 fnal， 不 能 修改 。 所 以 ，Java 程序 员 通 常 使 用 这 样 一 个 变通 
的 方法 : 开发 一 个 StingUtil K, 在 里 面 封装 所 需要 的 String 操作 的 方法 ， 而 不 是 修改 或 继 
承 String 类 。 

而 在 Kotlin 里 ,情况 就 完全 不 一 样 了 一 一 我 们 完全 可 以 自由 扩展 任何 类 的 方法 和 属性 。 
在 不 修改 原 类 的 情况 下 ，Kotlin 能 给 一 个 类 扩展 新 功能 而 无 须 继承 该 类 。 

本 章 我 们 将 介绍 Kotlin 的 扩展 函数 和 属性 。 


61 扩展 函数 


Kotlin 中 提供 了 使 用 非常 简单 的 扩展 函数 功能 。 我 们 可 以 为 现 有 的 类 自由 添加 自 定义 
的 函数 。 


6.1.1 给 String 类 扩展 两 个 函数 


例如 ， 现 在 给 String 类 扩展 两 个 函数 firstChar0 和 lastChar0， 实 现代 码 如 下 : 


package com.easy.kotlin 


fun String.firstChar(): String {//Kotlin 中 给 String 扩展 一 个 firstChar 函数 
if (this.length == 0) { 
return "" 
} 
return this[0] .toString() 
} 


fun String.lastChar(): String { //Kotlin 中 给 String 扩展 一 个 lastChar 函数 
if (this.length == 0) { 
return "" 
} 
return this[this.length - 1] .toString() 
} 


扩展 函数 的 语法 可 以 用 图 6-1 来 简单 说 明 。 


rE 
点 号 


目标 类 型 扩展 函数 名 


+H 


fun String.firstChar(): String { 
if (this.length == 0) { 
return "" 


} 
return this[0].toStringO 


图 6-1 给 String 类 型 扩展 一 个 frstChar0 函 数 
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然后 就 可 以 在 代码 中 直接 调用 了 : 
fun main(args: Array<String>) { 
println("abc".firstChar ()) // 返 回 a 


println("abc".lastChar ()) // 返 回 c 
} 


如 果 在 其 他 package 路 径 下 面 ， 则 需要 import 导入 扩展 函数 : 
package com.easy.kotlin.tutorial ”// 与 扩展 函数 不 在 同一 个 包 路 径 下 


import com.easy.kotlin.firstChar  // 导 入 扩展 函数 firstChar () 
import com.easy.kotlin.lastChar // 导 入 扩展 函数 lastChar () 


fun main(args: Array<String>) { 
val str = "abc" 


str.firstChar() // 这 样 的 调用 方式 要 比 StringUtil.firstChar(str) 简单 许多 
str.lastChar () 


6.1.2 给 List 类 扩展 一 个 过 滤 函 数 


在 第 5 章 中 我 们 介绍 过 List 的 filter0 函 数 。 那么 这 个 filter0 函 数 是 怎样 实现 的 呢 ? 如 
果 我 们 自己 给 List 类 扩展 一 个 过 滤 函 数 ， 应 该 怎样 去 做 呢 ? 下 面 我 们 就 来 解决 这 个 问题 。 
为 了 让 读者 能 更 加 深刻 地 体会 到 Kotlin 扩展 功能 的 简单 、 优 雅 性 ,我 们 先 来 看 看 在 Java 
中 是 怎样 实现 的 吧 ! 首先 ， 我 们 会 去 声明 一 个 ListUtil 类 ， 里 面 实现 一 个 List filter(List 
list,Predicatep) 方 法 ， 代 码 如 下 : 
public class ListUtil<T> { 
/冰冰 
* 根据 谓词 p 过 滤 List 中 的 元 素 
* 
* @param list 
* @param p 
* @return 
Mi 
public List<T>filter (List<T>list, Predicate<T> p) { 
//Java 中 的 filter() 方 法 的 实现 


List<T> result = new ArrayList<>(); 
For (HU E s ESEN ott 
if (p.predicate(t)) { // 如 果 满足 判定 条 件 
result.add (t); // 添 加 该 元 素 到 result () 列表 中 
} 
} 


return result; 
D 
其 中 ，Predicate 接口 声明 如 下 : 


interface Predicate<T> { 
Boolean predicate(T t); // 返 回 布尔 值 的 谓词 函数 
$ 
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然后 ， 我 们 在 代码 中 这 样 使 用 这 个 filter0 方 法 : 


public static void main(String[] args) { 
List<Integer> list = Arrays.asList (new Integer[] {1, 2, 3, 4, 5, 6, 7}); 
ListUtil<Integer> listUtil = new ListUtil(); // 声 明 ListUtil WE 


List<Integer> result = listUtil.filter(list, (it) -> it % 2 == 1); 
//Lambda 表达 式 
out .println (result); Ja 11, 3, 5, 71 


} 

为 了 调用 filter0 方 法 ,我们 还 要 声明 一 个 ListUtil 对 象 ， 这 样 显 得 比较 麻烦 。 能 不 能 
接 像 下 面 这 样 调用 呢 ? 

list.filter { it $ 2 ==1 } 

答案 是 肯定 的 , 只 不 过 必须 是 在 Kotlin F, 而 不 是 在 Java 中 。 下 面 我 们 就 来 使 用 Kotlin 
中 的 扩展 函数 为 List 扩展 一 个 filter0 函 数 ， 代 码 如 下 : 

fun <T> List<T>.filter (predicate: (T) -> Boolean): MutableList<T> { 


//Koltin 中 给 List 类 扩展 一 个 filter 函数 
val result = ArrayList<T>() 


this.forEach { // 这 里 的 this 指向 调用 者 对 象 
if (predicate(it)) { // 如 果 满 足 谓 词 判断 条 件 
result.add(it) 
} 
} 


return result 


2 
这 个 函数 的 签名 稍微 有 点 复杂 ， 我 们 用 图 6-2 来 形象 化 地 简单 说 明 。 


as 


1 
点 号 


目标 类 型 “| 扩展 函数 名 函数 返回 类 型 
fun <T> List<T>.filter(predicate: (T) -> Boolean): MutableList<T> 
LH L J 
Y 


类 型 参数 GERD 函数 入 参 


图 6-2 filter0 函 数 的 签名 


然后 我 们 在 代码 中 只 需要 这 样 调用 即 可 : 


val list = mutableListOf(1, 2, 3, 4, 5, 6, 7) 
val result = list.filter { 


it % 2 = 1 // 这 是 一 个 Lambda 函数 
} 
println(result) //(1, 3, 5, 7) 


Kotlin 的 标准 库 API 中 使 用 了 扩展 的 功能 ， 通 过 扩展 Java 的 API， 提 供 了 大 量 实用 且 
简单 的 函数 ， 这 部 分 内 容 将 在 第 9 章 中 具体 介绍 。 
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62 扩展 属性 


除了 扩展 一 个 类 的 函数 ， 还 可 以 扩展 类 属性 。 例 如 ， 我 们 给 MutableList 扩展 两 个 属 


性 : firstElement 和 lastElement， 实 现代 码 如 下 : 


Var <T> MutableList<T>.firstElement: T 
get () // 扩 展 属性 firstElement 的 get () 函数 
return this[0] // 返 回 第 1 个 元 素 
} 
set (value) { 
this[0] = 


// 扩 展 属性 firstElement DI set () 函数 
value // 设 置 第 1 个 元 素 为 value 
} 
var <T> MutableList<T>.lastElement: T 
get () 

return this[this.size - 1] // 返 回 最 后 一 个 元 素 
} 


set(value) { 
this[this.size - 1] = 


value // 设 置 最 后 一 个 元 素 的 值 为 value 
} 


上 面 代码 中 扩展 属性 的 语法 说 明 如 图 6-3 所 示 。 


类 型 参数 点 号 ge 


属性 可 变性 目标 类 型 扩展 属性 名 
re l ilr 3 1 
var <T> MutableList<T>.firstElement:T 一 扩展 属性 的 类 型 
gert) { 
return this[0] 


getter 国 数 
} 
set(value) { 
this[0] = value setter 国 数 
} 
图 6-3 扩展 属性 的 语法 说 明 


然后 就 可 以 在 代码 中 直接 使 用 扩展 的 属性 了 : 


val list = mutableListOf(1, 2, 3, 4, 5, 6, 7) 

printin last = S1List /Wst — IL 293, 4 5i 6 M 
printlin(list.firstElement) // 调 用 getter 函数 ， 值 是 1 
println(list.lastElement) //7 

list.firstElement = -1 // 调 用 setter 函数 
list.lastElement = -7 

perntint Tlst = StListie y] Miist = F1 Z2, 37 4 57 Or ST 
printin(list.firstElement) //-1 

printin(list.lastElement) //-7 
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Kotlin 从 入 门 到 进 阶 实 战 


扩展 属性 允许 定义 在 类 或 者 Kotlin 文件 中 ， 不 允许 定义 在 函数 中 。 


63 扩展 的 实现 原理 


扩展 属性 和 扩展 函数 的 本 质 是 以 静态 导入 的 方式 来 实现 的 。 其 背后 的 实现 原理 可 以 通 
过 Kotlin 代码 的 ByteCode 来 理解 。 例 如 我 们 在 6.1.1 节 中 给 String 类 型 扩展 的 firstChar() 
函数 : 


fun String.firstChar(): String { 
if (this.length == 0) { 
return "" 
} 


return this[0] .toString() 
} 


它 对 应 的 JVM 码 如 下 : 


//access flags 0x19 
public final static firstChar (Ljava/lang/String;) Ljava/lang/String; 


@Lorg/jetbrains/annotations/NotNul1; () //invisible 
@Lorg/jetbrains/annotations/NotNull;() //invisible, parameter 0 
LO 
ALOAD 0 


LDC "S$receiver" 


INVOKESTATIC kotlin/jvm/internal/Intrinsics.checkParameterIsNotNull 
(Ljava/lang/Object; Ljava/lang/String;)V 
L1 


LINENUMBER 4 L1 
ALOAD 0 


INVOKEVIRTUAL java/lang/String.length ()I 

IFNE L2 

L3 

LINENUMBER 5 L3 

LDC ™ 

ARETURN 

L2 

LINENUMBER 7 L2 

ALOAD 0 

ICONST 0 

INVOKEVIRTUAL java/lang/String.charAt (I)C 
INVOKESTATIC java/lang/String.valueOf (C)Ljava/lang/String; 
ARETURN 
L4 

LOCALVARIABLE $receiver Ljava/lang/String; LO L4 0 
MAXSTACK = 2 

MAXLOCALS = 1 


直接 看 上 面 的 JVM 指令 可 能 不 直观 ， 反 编译 成 Java 代码 后 会 更 清楚 : 


public static final String firstChar(@NotNull String $receiver) { 
Intrinsics.checkParameterIsNotNull ($receiver, 


"Sreceiver"); 
return $receiver.length() == 0 ? "" : String.valueOf ($receiver. charAt (0)); 
| 
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6.4 扩展 中 的 this 关键 字 


在 前 面 的 List 扩 展 函 数 filter0 的 实现 中 ， 用 到 了 一 个 this 关键 字 : 


this.forEach { //this 关键 字 

if (predicate(it)) { 

result.add(it) 

} 
i 
这 里 的 this 指 的 是 接收 者 对 象 (receiver object) ， 也 就 是 调用 扩展 函数 时 ， 在 点 号 “.” 

之 前 指定 的 对 象 实例 。 为 了 表示 当前 函数 的 接收 者 (receiver) , Kotlin 中 使 用 this KIAR: 

O 在 类 的 成 员 函 数 中 ，this 指向 这 个 类 的 当前 对 象 实例 ; 
O 在 扩展 函数 中 ， 或 带 接收 者 的 函数 字面 值 Cfunction literal) 中 ，this 代表 调用 函数 


D 如 果 this 没有 限定 符 ， 那 么 它 指 向 包含 当前 代码 的 最 内 层 范围 。 如 果 想 要 指向 其 
他 范围 内 的 this， 需 要 使 用 标签 限定 符 。 
全 编程 技巧 提示 : 可 以 新 建 一 个 公共 源 文件 ， 把 自 定 义 的 扩展 属性 和 扩展 函数 都 放 到 包 
中 ， 作 为 一 个 通用 工具 类 来 使 用 。 


65 本 章 小 结 


扩展 函数 是 Kotin 中 非常 方便 且 实 用 的 功能 ， 使 用 扩展 函数 ， 可 以 使 我 们 的 代码 写 起 
来 更 加 简单 。 同时 也 正 是 通过 这 个 特性 , 使 Kotlin 在 Java API 的 基础 上 扩展 了 丰富 实用 的 
函数 ， 我 们 将 在 后 面 的 章节 中 具体 介绍 。 
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在 Java 类 库 中 有 一 套 相 当 完 整 的 容器 集合 类 来 持 有 对 象 。Kotlin 没有 去 重复 造 轮 子 
(Scala 则 是 自己 实现 了 一 套 集合 类 框架 ) ， 而 是 在 Java 类 库 的 基础 上 进行 了 改造 和 扩展 ， 
引入 了 不 可 变 集合 类 ， 同 时 扩展 了 大 量 方便 实用 的 功能 ， 这 些 功 能 的 API 都 在 
kotlin.collections 包 下 面 。 

另外 ， 在 Kotlin 的 集合 类 中 不 仅仅 能 持 有 普通 对 象 ， 而 且 能 够 持 有 函数 类 型 的 变量 。 
例如 下 面 是 一 个 持 有 两 个 函数 的 集合 类 : 

val funlist: List< (Int) ->Boolean>=// 声 明 一 个 持 有 类 型 为 函数 (Int) -> Boolean 的 List 


listof({ it -> it % 2 == 0 }, // 第 1 个 函数 为 { it ->it $2==0} 
2 // 第 2 个 函数 为 { it -> it %2==1} 


其 中 ，(Int)->Boolean 是 一 个 从 Int 映射 到 Boolean 的 函数 。 而 这 个 时 候 ， 我 们 可 以 在 
代码 里 选择 调用 哪个 函数 : 

vat ist = istoni A. ey A Gy ta, T) 

list.filter(funlist(0]) // 传 入 第 1 个 函数 funlist[0], 返 回 [2，4，6] 

list.filter(funlist[1]) // 传 入 第 2 个 函数 funlist[1], 返 回 [L，3，5，7] 

是 不 是 感觉 很 有 意思 ? 这 就 是 面向 对 象 范式 混合 函数 式 编程 的 自由 乐趣 吧 ! 

本 章 将 介绍 Kotlin 标准 库 中 的 集合 类 , 我 们 将 了 解 到 它 是 如 何 扩展 Java 集合 库 的 , 使 
代码 写 起 来 更 加 简单 、 容 易 。 


7.1 集合 类 概述 


集合 类 存放 的 都 是 对 象 的 引用 ， 而 非 对 象 本 身 ， 我 们 通常 说 的 集合 中 的 对 象 指 的 是 集 
合 中 对 象 的 引用 (reference)。 
Kotlin 的 集合 类 分 为 ， 可 变 集 合 类 (Mutable) 与 不 可 变 集 合 类 (Immutable) 。 


7.1.1 常用 的 3 种 集合 类 


集合 类 主要 有 3 种 : List GJR) 、Set CE) 和 Map (了 映射) ， 如 图 7-1 所 示 。 
List 容器 中 的 元 素 以 线性 方式 存储 ， 集 合 中 可 以 存放 重复 对 象 。 列 表 中 的 元 素 是 有 序 


地 排列 。 


List (列表 ) 


Set ( 集 ) 


Kotlin 集合 类 


图 7-1 Kotlin 集合 


Map (映射 ) 


Set 集 容器 的 元 素 无 序 、 不 重复 。 

Map 映射 中 持 有 的 是 “ 键 值 对 ”对 象 ， 每 一 个 对 象 都 包含 一 对 键 值 K-V 对 象 。Map 
映射 容器 中 存储 的 每 个 对 象 都 有 一 个 相关 的 关键 字 (Key) 对 象 ， 关 键 字 决 定 对 象 在 映射 
中 的 存储 位 置 。 关 键 字 是 唯一 的 。 其 实 关键 字 本 身 并 不 能 决定 对 象 的 存储 位 置 ， 它 通过 散 
列 (hashing) 产生 一 个 被 称 做 散 列 码 (hash code) 的 整数 值 ， 这 个 散 列 码 对 应 值 (Value) 
的 存储 位 置 。 

如 果 我 们 从 数据 结构 的 本 质 上 来 看 ， 其 实 List 中 的 下 标 就 是 Key， 只 不 过 Key 是 有 序 
的 Int 类 型 ， 所 以 说 List 也 可 以 说 是 一 种 特殊 的 Map 数据 结构 。 而 Set 也 是 Key 为 Int 类 
型 ， 但 是 Value 值 是 不 能 重复 的 特殊 Map. 


7.1.2 Kotlin 集合 类 继承 层次 


下 面 是 Kotlin 中 集合 类 接口 的 结构 层次 ， 如 图 7-2 所 示 。 


Lu | [seen | 
= weens | 


e 


| | 


| MutableList | | MutableSet | MutableMap 


图 7-2 集合 类 接口 结构 层次 


DEER 
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其 中 ， 各 个 接口 说 明 如 表 7-1 所 示 。 


表 7-1 集合 类 接口 说 明 
接 a 功 能 
Iterable 父 类 。 任 何 类 继承 这 个 接口 就 表示 可 以 遍历 序列 的 元 素 
Mutablelterable 在 迭代 期 间 支 持 删 除 元 素 的 迭代 
Collection List 和 Set 的 父 类 接口 。 只 读 不 可 变 
MutableCollection | 支持 添加 和 删除 元 素 的 Collection。 它 提供 写 入 的 函数 ， 如 add, remove 或 clear 等 
List 最 常用 的 集合 ， 继 承 Collection 接口 ， 元 素 有 序 ， 只 读 不 可 变 
konti 继承 List, 支持 添加 和 删除 元 素 , 除了 拥有 List 中 读数 据 的 函数 , 还 有 add, remove 
或 clear 等 写 入 数据 的 函数 
Set 元 素 无 重复 、 无 序 。 继 承 Collection 接口 。 只 读 不 可 变 
MutableSet 继承 Set， 支 持 添加 和 删除 元 素 的 Set 
Map 存储 K-V (Rn) 对 的 集合 。 在 Map 映射 表 中 Key Cit) 是 唯一 的 
MutableMap 支持 添加 和 删除 元 素 的 Map 


72 ”不 可 变 集 合 类 


List 列表 分 为 只 读 不 可 变 的 List 和 可 变 MutableList 〈 可 写 入 、 删 除数 据 ) 。List 列表 
的 类 型 层次 结构 如 图 7-3 所 示 。 


MutableListlterator<T> [< 


Iterator<out T> 


Listlterator<out T> 


Mutableterable<out T> 


MutableCollection<E> 


Iterable<out T> [< 
Collection<out E> [9 


MutableList<E> 


图 7-3 List 列表 的 类 型 层次 结构 


Set 集 也 分 为 不 可 变 Set 和 可 变 MutableSet( 可 写 入 、 删 除数 据 ) 。Set 集合 的 类 型 层 


次 结构 如 图 7-4 所 示 。 


Kotlin 中 的 Map 与 List、 Set 一 样 , Map 也 分 为 只 读 Map 和 可 变 MutableMap (可 写 入 、 
删除 数据 ) 。Map 没有 继承 于 Collection 接口 。Map 类 型 的 层次 结构 如 图 7-5 所 示 。 
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iterator<out T> ] Herable<out T> Mutablelterablecout T> 
‘operator fun next): T ‘operator fun itarator(): 
operator fun haeNext(): Boolean Tiniis override fun iterator(): Mutablaiterator<T> 


LH override fun isEmptyl): Boolean 


i i 


Collectioncout E> MutableCollectioncE> 


override fun iterator(): Mutablelterator<E> 
fun addlelemant: E): Boolean 

fun remove(lement: E): Boolean 

fun addAllelements: CollectionE>): Boolean 
fun romovedli(olements: Colloction<E>): Booloan 
fun retainAli(elements: Collection<E>): Boolean 
fun clear): Unit 


i i 


Set<out E> MutableSet<E> 


val size: Int 
fun isEmptyl): Boolean 

‘operator fun containa(olement: @UnsateVariance EL Boolesn 
override fun iterator(): lterator<E> 

fun containsAll(elements: Collection<@UnsafeVeriance E>): 
Boolean 


override fun Rerator(): Mutablelterator<E> 
override fun addlelement: E): Boolean 

override fun remove(olomont: E): Boolean 

override fun addAli(slements: Collection<E>}: Boolean 
override fun removeAli(elements: Collection<E>): 
Boolean 

override fun retainAll(elements:; Collection<E>): 
Boolean 

override tun clear(): Unit 


override val size: Int 


override fun contains(element: @UnsafeVariance E): Boolean 
override fun iterator(|: terator<E> 

override fun containsAlKelements: 
Collection<@UnsafeVariance E>): Boolean 


Mutablelterator<T> 


Entry<out K, out V> 


val key: 
val valu 


MutableEntry<K, V> ` 
Map.Entry<K, V> 


fun setValue(newValue: V): V 


fun removel): Unit 


val size: Int Set<k> 
val keys: Set<K> 

val values: Collection<V> 

val entries: Set<Map.Entry<K, V>> 
interface Entry<out K, out V> 


isEmpty(): Boolean 
containsKey(key: K): Boolean 
containsValue(value: @UnsafeVariance V): Boolean Collection<V> 
operator fun getikey: K): V? 

getOrDefault(key: K, defaultValue: @UnsafeVariance V): V 


‘override val keys: MutableSet<K> 
override val values: MutableCollection<V> 

override val entries: MutableSet<MutableMap MutableEntry<k, V>> 
interface MutableEntry<k, V> : Map.Entry<K, V> 

put(key K, value: V): V? 

remove(key: K): V? 

removelkey: K, value: V): Boolean 

putAll(from: Map<out K, V>): Unit 

clear(): Unit 


1—- MutableSet<k> 
1 


1 
1 
1 
| 
1 
1 
1 
1 


— 5) MutableCollection<V> 


图 7-5 Map 类 型 的 层次 结构 


下 面 ， 我 们 来 创建 集合 


Kotlin 中 分 别 使 月 


7.3 创建 集合 类 


H listOfO, sert), 、mapOfO 函 数 创建 不 可 变 的 List 列表 容器 、Set HE 
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容器 、Map 映射 容器 ; 使 用 mutableListOfQ. mutableSetOf(). mutableMapOf( A BOK BY 
可 变 的 MutableList 列表 容器 、MutableSet 427525. MutableMap 映射 容器 ， 分 别 如 图 7-6 
至 图 7-8 所 示 。 


listof0 © ”使 用 ArrayList 实 现 ,返回 的 list 是 只 读 的 
创建 List O, 


图 7-6 创建 List 


emptySet(): Set - 创建 一 个 空 的 只 读 Set 
创建 Set © | setOf(vararg T): Set - 创建 一 个 只 读 Set 


| mutableSetOf(vararg elements): MutableSet - 创建 一 个 可 变 Set 


图 7-7 创建 Set 


mapOf() 
基于 Jace 的 LinkedHack Map 
mutableMapOf() 


创建 Map ©| hashMapOf) ©  valhashMap = hashMapOf(lto bookA, 2 to bookB) 


linkedMapof0 ©  valmap= mapOf<Int, Book to bookA, 2 to bookB) 


创建 一 个 空 的 Map ©  valmapEmpty = emptyMap<Int, Book>() 


图 7-8 创建 Map 


代码 示例 如 下 : 


a se (ia EE // 创 建 不 可 变 List 
val mutableList = mutableListOf("a", "b", "ent // 创 建 可 变 MutableList 
val set = setOf(1, 2, 3, 4, 5, 6, 7) // 创 建 不 可 变 Set 
val mutableSet = mutableSetOf("a", "b", "c") // 创 建 可 变 MutableSet 
val map = papõf ti to 7a", 2 to Tb”, 3 to Ten) // 创 建 不 可 变 Map 


val mutableMap = mutableMapOf(1 to"X",2 to"Y",3 to"Z") // 创 建 可 变 MutableMap 
如 果 创建 没有 元 素 的 空 List, 使 用 listofO 即 可 。 不 过 这 个 时 候 ,变量 的 类 型 不 能 省 略 ， 
需要 显 式 声明 : 


val emptyList: List<Int> = listof() // 显 式 声明 List 的 元 素 类 型 为 Int 


val emptySet: Set<Int> = setOf() // 显 式 声明 Set 的 元 素 类 型 为 Int 

val emptyMap: Map<Int，String> = mapOf () // 显 式 声明 Map 的 元 素 类 型 为 Int，String 键 值 对 
否则 会 报错 : 

>>> val list = listof() // 不 指定 类 型 ， 声 明 一 个 空 List 会 报错 


error: type inference failed: Not enough information to infer parameter T 
in inline fun <T> listOf(): List<T> 
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理 ， 


Map 


Please specify it explicitly. 
val list = listOf() 


因为 这 里 的 funlistOf(:List 泛 型 参数 工 编 译 器 无 法 推断 出 来 。setOfOD 、mapOfO 分 析 同 
ARG 
74 遍历 集合 中 的 元 素 


List, Set 类 继承 了 Iterable 接口 ， 里 面 扩 展 了 forEach 函数 来 迭代 遍历 元 素 ; 同样 ， 


接口 中 也 扩展 了 forEach 函数 来 迭代 遍历 元 素 。 

list.forEach { //List 中 的 forEach 
println(it) 

} 

set.forEach { //Set 中 的 forEach 
println (it) 

map.forEach { //Map 中 的 forEach 


println("K = ${it.key}, V=${it.value}") //Map 里 面 的 对 象 是 Map .Entry<K，V> 
} 


其 中 ，forEach0) 函 数 签名 如 下 : 


public inline fun <T> Iterable<T>.forEach(action: (T) -> Unit): Unit 
public inline fun <K, V> Map<out K, V>.forEach(action: (Map.Entry<K, V>) 
> Unit) Uma 


我 们 看 到 ， 在 Iterable 和 Map 中 ，forEach 函数 都 是 一 个 内 联 inline 函数 。 
另外 ， 如 果 我 们 想 在 迭代 遍历 元 素 的 时 候 访 问 index 下 标 ， 在 List 和 Set 中 可 以 使 用 


下 面 的 forEachIndexed 函数 


list.forEachIndexed { index, value -> // 带 下 标 index 来 遍历 List 
println ("list index = ${index} , value = ${value}") 


} 
set.forEachIndexed { index, value ->  // 带 下 标 index 来 遍历 Set 
println("set index = ${index} , value = ${value}") 


其 中 ， 第 1 个 参数 是 index, "8 2 个 参数 是 value。 这 里 的 forEachIndexed 函数 签名 


如 下 : 


public inline fun <T> Iterable<T>.forEachIndexed(action: (index: Int, T) 
=> Unit): Unit 


Map 的 元 素 是 Entry 类 型 ， entries 属性 持 有 。 


val entries: Set<Entry<K, V>> 


这 个 Entry 类 型 定义 如 下 : 


public interface Entry<out K, out V> { 
public val key: K // 键 值 对 的 Key 
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public val value: V // 键 值 对 的 Value 
} 


我 们 可 以 直接 访问 entries 属性 获取 该 Map 中 的 所 有 键 / 值 对 的 Set。 代 码 示例 如 下 : 


>>> val map = mapOf("x" to 1, "y" to 2, "z" to 3) // 声 明 并 初始 化 一 个 Map 
>>> map 

{x=1, y=2, z=3} 

>>> map.entries // 访 问 Map NEID entries 属性 
[x=1, y=2, 2=3] 


这 样 就 可 以 遍历 这 个 Entry 的 Set 了 : 


>>> map.entries.forEach ({println("key="+ it.key + " value=" + it.value) }) 


// 遍 历 entries 中 的 元 素 
key=x value=1 
key=y value=2 
key=z value=3 


7.5 映射 函数 


使 用 map 函数 ， 可 以 把 集合 中 的 元 素 依次 使 用 给 定 的 转换 函数 进行 映射 操作 ， 元 素 映 


射 之 后 的 新 值 会 在 入 一 个 新 的 集合 中 ,并 返回 这 个 新 集合 。 这 个 过 程 可 以 用 图 7-9 来 说 明 。 


Pee OF OTe are 


map 国 数 


list.map {it*it} 
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图 7-9 map 函数 的 映射 图 


在 List, Set 继承 的 Iterable 接口 和 Map 接口 中 ， 都 提供 了 这 个 map 函数 。 使 用 map 


函数 的 代码 示例 如 下 : 
EECH // 声 明 并 初始 化 一 个 List 
val set = SGEOE 2, 3, EEN // 声 明 并 初始 化 一 个 Set 


val map = mapOf(1 to "a", 2 to "b", 3 to "c") // 声 明 并 初始 化 一 个 Map 


list.map { it * it } //map 函数 对 每 个 元 素 进 行 乘 方 操作 ， 返 回 [1, 4, 9, 16, 25, 36, 49] 
set.map{ it + 1} //map 函数 对 每 个 元 素 进行 加 1 操作， 返回 [2,，3,，, 4, 5, 6, 7, 8] 
map.map{ it.value + "$" } //map 函数 对 每 个 元 素 后 加 上 字符 $， 返 回 [a$，b$，c$] 
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map 函数 的 签名 如 下 : 


public inline fun <T, R> Iterable<T>.map (transform: (T) -> R): List<R> 
public inline fun <K, V, R> Map<out K, V>.map(transform: (Map.Entry<K, V>) 


-> R): List<R> 

这 里 的 R 类 型 是 映射 之 后 的 数据 类 型 ， 我 们 也 可 以 传 入 一 个 List: 
Valystmlistr— i eren 

stelist:map { 1t -> 11IstOf(GE t I, 1t t2, ae 4'3, it +A) 


//map 函数 ， 每 个 元 素 it 映射 之 后 返回 一 个 List, X^ 
List PA 4470K, DWM it+1,it+2, it+3,it+4 


这 个 时 候 ， 返 
返回 结果 如 下 : 


回 值 的 类 型 将 是 List， 也 就 是 一 个 List 里 面 嵌 套 一 个 List， 上 面 代 码 的 


(tat, a2, a3, a4], 2 


Kotlin 中 还 提供 了 一 个 flatten0 函 数 ， 效 果 是 把 嵌 套 的 List 结构 “ 平 铺 ”， 变 成 一 层 的 
结构 ， 代 码 示例 如 下 : 


strlist.map { it -> ListOE{(it + 1, it +2, it + 3, it +4) }.flatten() 
// CF” PRB, EREE List 中 的 元 素 “ 平 铺 ” 成 一 层 List 

输出 如 下 : 

iak aa aa AA BI 62 Klee et ees 

flatMap 函数 是 map 和 flat 两 个 函数 的 “复合 逻辑 ”， 代 码 示例 如 下 : 

SE ME tes EFA 

同样 输出 如 下 : 


下 
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在 第 5 章 中 ,我 们 已 经 讲 过 了 filter0 函 数 ,这 里 再 举 一 个 代码 示例 。 首 先 ,有 一 个 Student 
对 象 ， 我 们 使 用 数据 类 来 声明 如 下 : 


data class Student (var id: Long, var name: String, var age: Int, var score: 
Int) { // 声 明 Student 数据 类 
override fun toString(): String { //# ii toString() 函数 
return "Student (id=$id, name='$name', age=Sage, score=$score)" 
} 


} 


为 了 方便 读者 看 到 打印 信息 ， 重 写 了 toString0 函 数 。 然 后 创建 一 个 持 有 Student 对 象 
的 List: 


val studentList = listOf( 


// 创 建 一 个 持 有 Student WK List 
Student (1, "Jack", 18, 90), 
Student (2, "Rose", 17, 80), 
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Student (3, "Alice", 16, 70) 
) 


这 个 时 候 ， 如 果 我 们 想 要 过 滤 出 年 龄 大 于 等 于 18 岁 的 学 生 ， 代 码 可 以 这 样 写 : 


studentList.filter { 让 -age >= 18 } // 过 滤 出 studentList 中 年 龄 大 于 等 于 18 岁 的 
Student NS 


输出 如 下 : 

[Student (id=1, name='Jack', age=18, score=90)] 

如 果 想 要 过 滤 出 分 数 小 于 80 分 的 学 生 ， 代 码 如 下 : 

studentList.filter { it.score < 80 } // 过 滤 出 studentList 中 分 数 小 于 80 分 的 
Student 对 象 

输出 如 下 : 

[Student (id=3, name='Alice', age=16, score=70) ] 

另外 ， 如 果 想 要 通过 访问 下 标 来 过 滤 ， 可 以 使 用 filterIndexed() pA 2: 


val list = listOf(1, 2, 3, 4, 5, 6, 7) 
list.filterIndexed { index, it -> index % 2 == 0 && it > 3 } 


// 带 下 标 过 滤 List 中 的 元 素 ， 返 回 [5，7] 
filtermdexed0) 函 数 笃 名 如 下 : 


public inline fun <T> Iterable<T>.filterIndexed (predicate: (index: Int, T) 
-> Boolean): List<T> 


7.7 排序 函数 


Kotlin 集合 类 中 提供 了 倒序 排列 集合 元 素 的 函数 reversed0， 代 码 示例 如 下 : 


varise -En 
val set = setOf(1,3,2) 


list.reversed() // 倒 序 函 数 ， 返 回 [7，6，5，4，3，2，1] 
set.reversed () // 倒 序 函 数 ， 返 回 [2，3，1] 


这 个 Iterable 的 扩展 函数 reversed0 是 直接 调用 的 java.util.Collections.reverse() 方 法 。 其 
相关 代码 如 下 : 
public fun <T> Iterable<T>.reversed(): List<T> { 
if (this is Collection && size <= 1) return toList() 
val list = toMutableList () 
list.reverse() // 调 用 Java "P List 类 型 的 reverse() 方 法 


return list 


D 
public fun <T> MutableList<T>.reverse(): Unit { 


java.util.Collections.reverse (this) 


} 


=“ 100° 


第 7 章 集合 类 


升序 排序 函数 是 sorted0， 实 例 代码 如 下 : 

>>> list.sorted() 

a e ea e Ea U] 

>>> set.sorted() 

[1, 2, 3] 

Kotlin 中 的 这 个 sortedO 函 数 也 是 直接 调用 Java 的 API 来 实现 的 ， 相 关 代 码 如 下 : 


public fun <T : Comparable<T>> Iterable<T>.sorted(): List<T> { 
if (this is Collection) { 
if (size <= 1) return this-.toList () 
@Suppress ("UNCHECKED CAST") 
return (toTypedArray<Comparable<T>>()as Array<T>) .apply { sort ()}.asList () 
} 
return toMutableList().apply { sort() } 
} 
其 背后 调用 的 是 Java.util.Arrays.sort() 方 法 : 


public fun <T> Array<out T>.sort(): Unit { 
if (size > 1) java.util-.Arrays.sort (this) //iM/f Java "bh Arrays 类 型 的 sort 方法 
} 


78 元 素 去 重 


如 果 我 们 想 对 一 个 List 列表 进行 元 素 去 重 ， 可 以 直接 调用 distinct0 函 数 : 


TEE 
dupList.distinct () // 去 重 函数 ， 返 回 (1, 2, 3] 


Kotlin 的 集合 类 中 还 提供 了 许多 功能 丰富 的 API， 此 处 不 再 一 一 介绍 。 更 多 内 容 可 以 
参考 官方 API 文档: 
http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/index.html. 
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本 章 我 们 介绍 了 Kotlin 标准 库 中 的 集合 类 List、Set、Map， 以 及 它们 扩展 的 丰富 的 操 
作 函 数 ， 这 些 函数 使 得 我 们 使 用 这 些 集合 类 更 容易 。 集 合 类 持 有 的 是 对 象 ， 而 怎样 放 入 正 
确 的 对 象 类 型 则 是 我 们 写 代码 过 程 中 需要 注意 的 。 第 8 章 中 我 们 将 学 习 泛 型 。 
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通常 情况 的 类 和 函数 ， 我 们 只 需要 使 用 具体 的 类 型 即 可 : 要 么 是 基本 类 型 ， 要么 是 自 
定义 的 类 。 但 是 在 集合 类 的 场景 下 ， 我 们 通常 需要 编写 可 以 应 用 于 多 种 类 型 的 代码 ， 最 简 
单 的 做 法 是 针对 每 一 种 类 型 均 写 一 套 刻 板 的 代码 。 但 这 样 做 使 代码 的 复 用 率 很 低 ， 抽 象 也 
没有 做 好 。 那 么 我 们 能 不 能 把 “类 型 ”也 抽象 成 参数 呢 ? 答案 是 当然 可 以 。 

Java 5 中 引入 的 泛 型 机 制 实现 了 “参数 化 类 型 ” (Parameterized Type) 。 参 数 化 类 型 ， 
顾名思义 就 是 将 类 型 由 原来 的 具体 类 型 参数 化 ， 类 似 于 方法 中 的 变量 参数 ， 此 时 类 型 也 定 
义 成 参数 形式 ， 我 们 称 之 为 类 型 参数 ， 然 后 在 使 用 时 传 入 具体 的 类 型 〈 类 型 实 参 ) 。 

我 们 知道 ， 在 数学 中 泛 函 是 以 函数 为 自 变量 的 函数 。 类 似 的 ， 编 程 中 的 泛 型 就 是 以 类 
型 为 变量 的 类 型 ， 即 参数 化 类 型 。 这 样 的 变量 参数 就 叫 类 型 参数 (Type Parameters) 。 

本 章 我 们 来 一 起 学 习 Kotlin 泛 型 的 相关 知识 。 


8.1 为 何 引 入 泛 型 


(Java 编程 思想 》 (第 4 版 中 提 到 : 有 许多 原因 促成 了 泛 型 的 出 现 ， 而 最 引 人 注 意 
的 一 个 原因 ， 就 是 为 了 创建 容器 类 (集合 类 ) 。 
集合 类 可 以 说 是 我 们 在 写 代码 的 过 程 中 最 常用 的 类 之 一 。 我 们 先 来 看 下 没有 泛 型 之 
前 ， 集 合 类 是 怎样 持 有 对 象 的 。 在 Java H, Object 类 是 所 有 类 的 根 类 。 为 了 集合 类 的 通用 
性 ， 把 元 素 的 类 型 定义 为 Object， 当 放 入 具体 的 类 型 时 ， 再 进行 相应 的 强制 类 型 转换 。 
下 面 是 一 个 示例 代码 : 
class RawArrayList { 
public int length = 0; 
private Object[] elements; // 把 元 素 的 类 型 定义 为 Object 


public RawArrayList (int length) { // 构 造 函 数 

this.length = length; 

this.elements = new Object [length] ;// 创 建 一 个 长 度 为 length 的 Object 数组 
} 


public Object get (int index) { //get 方法 
return elements [index]; 


} 


public void add (int index, Object element) {// 给 下 标 位 置 为 index 的 元 素 赋值 为 element 
elements[index] = element; 
} 
} 
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一 个 简单 的 测试 代码 如 下 : 
public class RawTypeDemo { 


public static void main(String[] args) { 


RawArrayList rawArrayList = new RawArrayList (4); 

// 创 建 并 初始 化 一 个 持 有 元 素 长 度 为 4 的 RawArrayList WR 
rawArrayList.add(0, "a"); // 给 下 标 0 的 位 置 赋值 为 "a" 
rawArrayList.add(1, "b"); // 给 下 标 1 的 位 置 赋值 为 "b" 


System.out.print1n(rawArrayList) ; 


String a = (String) rawArrayList.get (0); // 返 回 下 标 为 0 的 元 素 
System.out.println (a); 


String b = (String) rawArrayList.get (1); // 返 回 下 标 为 1 的 元 素 
System.out.println (b); 


rawArrayList.add(2, 200); 
rawArrayList.add(3, 300); 
System.out.print1n(rawArrayList) ; 


int e (int) rawArrayList.get (2); 
int d (int) rawArrayList.get (3); 
System.out.printin(c); 
System.out .pintln(d) > 


String x = (String) rawArrayList.get (2); //Exception in thread "main" 
java.lang.ClassCastException: java.lang.Integer cannot be cast to 
java.lang.String 

System.out.printin (x); 


可 以 看 出 ， 在 使 用 原生 态 类 型 Craw type) 实现 的 集合 类 中 ， 我 们 使 用 的 是 Object[] 数 

这 种 实现 方式 存在 的 问题 有 两 个 : 

D 向 集合 中 添加 对 象 元 素 的 时 候 ， 没 有 对 元 素 的 类 型 进行 检查 。 也 就 是 说 ， 我 们 向 
集合 中 添加 任意 对 象 ， 编 译 器 都 不 会 报错 。 

口 当 我 们 从 集合 中 获取 一 个 值 的 时 候 ， 不 能 都 使 用 Object 类 型 ， 需 要 进行 强制 类 型 
转换 。 而 这 个 转换 过 程 由 于 在 添加 元 素 的 时 候 没有 做 任何 的 类 型 的 限制 与 检查 ， 
所 以 容易 出 错 。 例 如 上 面 代码 中 的 


String x = (String)rawArrayList.get(2); //Exception in thread "main" 
java.lang.ClassCastException: java.lang.Integer cannot be cast to 
java.lang.String 


对 于 这 行 代码 ， 编 译 时 不 会 报错 ， 但 是 运行 时 会 抛 出 类 型 转换 错误 。 能 不 能 让 编译 器 


来 解决 这 样 样板 化 的 类 型 转换 代码 呢 ? 能 和 否 在 我 们 向 rawArrayList 添加 元 素 的 时 候 


rawArrayList.add(0, "a"); 


就 限定 其 元 素 类 型 只 能 为 String， 然 后 在 后 面 获取 元 素 的 时 候 ， 自 动 强制 转型 为 


String 呢 ? 
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String a = (String) rawArrayList.get (0); 


我 们 将 这 个 元 素 类 型 String 的 信息 存放 到 一 个 “类 型 参数 ”中 ， 然 后 在 编译 器 层面 引 
入 相应 的 类 型 检查 和 自动 转换 机 制 ， 这 样 就 可 以 解决 类 型 安全 使 用 的 问题 了 。 这 也 正 是 引 
入 泛 型 的 基本 思想 。 

泛 型 最 主要 的 优点 就 是 让 编译 器 追踪 参数 类 型 ， 执 行 类 型 检查 和 类 型 转换 。 因 为 由 编 
译 器 来 保证 类 型 转换 不 会 失败 ， 如 果 依赖 程序 员 自 己 去 追踪 对 象 类 型 和 执行 转换 ， 那 么 运 
行 时 产生 的 错误 将 很 难 去 定位 和 调试 。 有 了 泛 型 ， 编 译 器 就 可 以 帮助 我 们 执行 大 量 的 类 型 
检查 ， 并 且 可 以 检测 出 更 多 的 编译 时 错误 。 在 这 一 点 上 ， 泛 型 与 第 3 章 中 所 讲 到 的 “可 空 
类 型 ”实现 的 空 指针 安全 ， 在 思想 上 有 着 异曲同工 之 妙 。 


8.2 在 类 、 接 口 和 函数 上 使 用 泛 型 


泛 型 类 、 泛 型 接口 和 泛 型 方法 具备 可 重用 性 、 类 型 安全 和 高 效 等 优点 。 在 集合 类 API 
中 大 量 地 使 用 了 泛 型 。 在 Java 中 我 们 可 以 为 类 、 接 口 和 方法 分 别 定义 泛 型 参数 ， 在 Kotlin 
中 也 同样 支持 。 本 节 我 们 分 别 介 绍 Kotlin 中 的 泛 型 接口 、 泛 型 类 和 泛 型 函数 。 


8.2.1 泛 型 接口 


下 面 先 举 一 个 简单 的 Kotlin 泛 型 接口 的 例子 。 


interface Generator<T> { // 类 型 参数 放 在 接口 名 称 后 面 : <T> 


operator fun next(): T // 接 口 函数 中 直接 使 用 类 型 了 


测试 代码 如 下 : 


fun testGenerator() { 


val gen = object : Generator<Int> { // 对 象 表达 式 
override fun next(): Int { 
return Random () .nextInt (10) 
} 
} 
println(gen.next ()) 
} 


这 里 我 们 使 用 object 关键 字 来 声明 一 个 Generator 实现 类 , 并 在 Lambda 表达 式 中 实现 
了 nextO 函 数 。 
Kotlin 中 Map 和 MutableMap 接口 的 定义 也 是 一 个 典型 的 泛 型 接口 的 例子 。 


public interface Map<K, out V> { Map 接口 的 泛 型 声明 <K, out V >, KF out 参数 ， 
我 们 在 后 面 会 讲解 


public fun containsKey (key: K) : Boolean 
public fun containsValue (value: QUnsafeVariance V) : Boolean 
public operator fun get (key: K): V? 
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public val keys: Set<K> 

public val values: Collection<V> 

public val entries: Set<Map.Entry<K, V>> 
} 


public interface MutableMap<K, V> : Map<K, V> { 
public fun put(key: K, value: V): V? 
public fun remove(key: K): V? 
public fun putAll (from: Map<out K, V>): Unit 


} 


例如 ， 使 用 mutableMapOfO 函 数 来 实例 化 一 个 可 变 Map: 


>>> val map = mutableMapOf<Int,String>(1 to "a", 2 to "b", 3 to "c") 
>>> map 
{1=a, 2=b, 3=c} 


Heth, mutableMapOf( RA AL 4% Aur, 
fun <K, V> mutableMapOf (vararg pairs: Pair<K, V>): MutableMap<K, V> 


这 里 的 类 型 参数 K AV 在 泛 型 类 型 被 实例 化 和 使 用 时 ， 将 被 实际 的 类 型 参数 所 替代 。 
在 mutableMapOf0) 函 数 中 ， 放 置 K、V 的 位 置 被 具体 的 Int 和 String 类 型 所 蔡 代 。 

泛 型 可 以 用 来 限制 集合 类 持 有 的 对 象 类 型 ， 这 样 使 得 类 型 更 加 安全 。 当 我 们 在 一 个 集 
合 类 里 面 放 入 了 错误 类 型 的 对 象 时 ， 编 译 器 就 会 报错 : 

>>> map.put ("5","e") 


error: type mismatch: inferred type is String but Int was expected 
map.put ("5", "e") 


Kotlin 中 有 类 型 推断 的 功能 ， 有 些 类 型 参数 可 以 直接 省 略 不 写 。mutableMapOfO 函 数 
后 面 的 类 型 参数 可 以 省 掉 不 写 : 


>>> val map = mutableMapOf(1 to "a", 2 to "b", 3 to "c") 
>>> map 
{l=a, 2=b, 3=c} 


8.2.2 泛 型 类 


我 们 直接 声明 一 个 带 类 型 参数 的 Container 类 ， 代 码 如 下 : 
class Container<K, V>(var key: K, var value: V) 
为 了 方便 测试 ， 我 们 重 写 toString0 函 数 ， 代 码 如 下 : 
class Container<K, V>(var key: K, var value: vil // 在 类 名 后 面 声明 泛 型 参数 <K， 
V>， 多 个 泛 型 使 用 去 号 隔 开 
override fun toString(): String { 
return "Container (key=$key, value=$value)" 
} 
i 
测试 代码 如 下 : 


fun testContainer() { 


:5s 
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val container=Container<Int, String>(1, "A") // <K, V> 被 具体 化 为 <Int，String> 
println (container) // 输 出 : container = Container (key=1, value=A) 


} 
8.2.3” 泛 型 函数 


在 泛 型 接口 和 泛 型 类 中 ， 我 们 都 在 类 名 和 接口 名 后 面 声明 了 泛 型 参数 。 而 实际 上 也 可 
以 直接 在 类 或 接口 中 的 函数 声明 泛 型 参数 或 者 在 包 级 函数 中 直接 声明 泛 型 参数 。 代 码 示例 
如 下 : 


class GenericClass { 
fun <T> console(t: T) { // 类 中 的 泛 型 函数 
Println(t) 
} 


} 


interface GenericInterface { 
fun <T> console(t: T) // 接 口中 的 泛 型 函数 
fun <T : Comparable<T>> gt(x: T, y: T): Boolean { // 包 中 的 泛 型 函数 
return x > Y 


} 
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在 上 面 的 例子 中 ，gt(x:T, Y:T) 函 数 的 签名 中 有 个 T:Comparable<T>: 


fun <T : Comparable<T>> gt (x: T, y: T): Boolean //T 的 类 型 上 界 是 Comparable<T> 


这 里 的 T:Comparable， 表 示 Comparable 是 类 型 T 的 上 界 。 也 就 是 告诉 编译 器 ， 类 型 
参数 T 代表 的 都 是 实现 了 Comparable 接口 的 类 ， 这 样 等 于 告诉 编译 器 它们 都 实现 了 
CompareTo 方法 。 如 果 没 有 在 这 个 类 型 上 界 进 行 声明 ， 就 无 法 直接 使 用 CompareTo“>” 
操作 符 。 也 就 是 说 ， 下 面 的 代码 编译 不 通过 。 


fun <T> gtx: T; y: T): Boolean { 
return x > y // 编 译 不 通过 
` 


8.4 协 变 与 逆 变 


我 们 先 来 看 一 个 问题 场景 。 首 先 有 下 面 存在 父子 关系 的 类 型 : 


open class Food 
open class Fruit : Food() //Fruit 继承 Food 


class Apple : Fruit() //Apple 继承 Fruit 
class Banana : Fruit() //Banana 继承 Fruit 
class Grape : Fruit() //Grape 继承 Fruit 
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然后 有 下 面 两 个 函数 : 


object GenericTypeDemo { 
fun addFruit (fruit: MutableList<Fruit>) { 


} 


fun getFruit (fruit: MutableList<Fruit>) { 


I 


这 个 时 候 可 以 这 样 调用 上 面 的 两 个 函数 : 


val fruits: MutableLis 


t<Fruit> = mutableListOf(Fruit(), Fruit(), Fruit()) 


GenericTypeDemo.addFruit (fruits) 
GenericTypeDemo.getFruit (fruits) 


现在 又 有 一 个 存放 Apple 的 List: 


val apples: MutableLis 


由 于 Kotlin 中 的 泛 型 与 Ja 


t<Apple> = mutableListOf (Apple(), Apple(), Apple()) 


va 一 样 是 非 协 变 的 ， 下 面 的 调用 是 编译 不 通过 的 : 


GenericTypeDemo.addFruit (apples) //type mismatch 
GenericTypeDemo.getFruit (apples) //type mismatch 


如 果 没 有 协 变 ， 那 么 我 们 不 得 不 再 添加 两 个 函数 : 


object GenericTypeDemo { 


fun addFruit (fruit 
} 


fun getFruit (fruit 
} 


fun addApple (apple 
ji 


fun getApple (apple 
} 


ji 
我 们 一 眼 就 能 看 出 , ES 


: MutableList<Fruit>) { 


: MutableList<Fruit>) { 


: MutableList<Apple>) { 


: MutableList<Apple>) { 


的 父 类 型 呢 ? Java 泛 型 中 引入 
两 种 形式 : 


EE 复 的 样板 代码 。 那么 能 不 能 让 MutableList 成 为 MutableList 
了 类 型 通配符 的 概念 来 解决 这 个 问题 。Java 泛 型 的 通配符 有 


O 子 类 型 上 界限 定 符 ?extendsT 指定 类 型 参数 的 上 限 〈 该 类 型 必须 是 类 型 T 或 者 它 的 
子 类 型 ) 。 也 就 是 说 MutableList<?extends Fruit> 是 MutableList 的 父 类 型 。Kotlin 


中 使 用 MutableList 来 


表示 。 


O 超 类 型 下 界限 定 符 ?superT 指定 类 型 参数 的 下 限 〈 该 类 型 必须 是 类 型 T 或 者 它 的 父 
类 型 ) 。 也 就 是 说 MutableList<?super Fruit># MutableList 的 父 类 型 。Kotlin 中 使 


用 MutableList 来 表示 


这 里 的 问号 “?”， 称 之 为 类 型 通配符 (Type Wildcard) 。 通 配 符 在 类 型 系统 中 具有 重 
要 的 意义 ， 它 们 为 一 个 泛 型 类 所 指定 的 类 型 集合 提供 了 一 个 有 用 的 类 型 范围 。 
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Number 类 型 ( 简 记 为 了 ) 是 Integer 类 型 〈 简 记 为 C) 的 父 类 型 ， 我 们 把 这 种 父子 类 

型 关系 简 记 为 C=>F (CC 继承 F) ; 而 List,List 代表 的 泛 型 类 型 信息 分 别 简 记 为 KF),f(C)。 
那么 我 们 可 以 这 样 描述 协 变 和 逆 变 : 

OQ CF, WRA C => KE)， 屠 么 f 叫 做 协 变 ; 

O 当 C >F 时 ， 如 果 有 fF) => fC)， 那 么 了 叫做 逆 变 。 如 果 上 面 两 种 关系 都 不 成 立 
则 叫做 不 变 。 

办 变 与 逆 变 可 以 用 图 8-1 来 简单 说 明 。 


we 
协 变 MY itn 


图 8-1 协 变 与 逆 变 


协 变 和 逆 协 变 都 是 类 型 安全 的 。 
8.4.1 he 


Java 中 的 数组 是 协 变 的 ， 下 面 的 代码 是 可 以 正确 编译 运行 的 : 


Integer[] 20 = new Integer[3]; 


ints[0] = 
ints[1] = 1; 
ints[2] = 2; 


Number[] numbers = new Number[3]; 


numbers = ints; // 数 组 是 协 变 的 ， 可 以 正确 赋值 

for (Number n : numbers) { 
System.out.println (n); 

} 


在 Java 中 ， 因 为 Integer 是 Number 的 子 类 型 ,数组 类 型 Integer[] 也 是 Number[] 的 子 类 
型 , 因此 在 任何 需要 Number[] 值 的 地 方 都 可 以 提供 一 个 Integer[] 值 。 Java 中 数组 协 变 的 意 
思 可 以 用 图 8-2 来 简单 说 明 。 

Java 中 的 泛 型 是 非 协 变 的 ， 如 图 8-3 所 示 。 

也 就 是 说 ，List<Integer> 不 是 List<Number> 的 子 类 型 ， 在 要 求 List<Number> 的 位 置 提 
供 List<Integer> 会 提示 类 型 错误 。 下 面 的 代码 ， 编 译 器 是 会 直接 报错 的 : 


List<Integer> integerList = new ArrayList<>(); 
integerList.add(0); 

integerList.add(1); 

integerList.add(2); 

List<Number> numberList = new ArrayList<>(); 
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numberList = integerList; // 编 译 错误 : 类 型 不 兼容 


Number List<Number> 


Number Number[] 


Da Ae | wi A 


Integer Integer[] Integer List<Interger> 


图 8-2 Java 中 的 数组 是 协 变 的 图 8-3 Java 中 的 泛 型 是 非 协 变 的 


编译 器 报错 提示 如 图 8-4 所 示 。 


List<Integer> integerList = new ArrayListo(); 
integerList.add(@); 

integerList.add(1); 

integerList.add(2); 

List<Number> numberList = new ArrayList>(); 


S numberList = integerList; 


Incompatible types. 
Required: List <java.lang.Number> 


| Found: List <java.lang.Integer> 
f 


图 8-4 编译 错误 : 类 型 不 兼容 


Java 中 泛 型 和 数组 的 不 同行 为 的 确 引 起 了 许多 混乱 ， 就 算 我 们 使 用 通配符 这 样 写 : 


List<? extends Number> list = new ArrayList<Number>(); 
list.add(new Integer(1)); //error 


仍然 是 报错 的 ， 如 图 8-5 所 示 。 


List<? extends Number: List = new ArrayList<Number>(); 
List.add(new Integer( value: 1)); //error | 


add (capture<? extends java.lang.Number>) in List cannot be applied 


to (java.lang.Integer) 


图 8-5 ”类 型 不 兼容 的 报错 信息 


这 通常 会 让 我 们 感到 困惑 : 为 什么 Number 的 对 象 可 以 由 Integer 实例 化 ， 而 
ArrayList<Number> 的 对 象 却 不 能 由 ArrayList<Integer> SE {il 4% ? list 中 的 <? extends 
Number> 声 明 其 元 素 是 Number 5k Number 的 派生 类 ， 为 什么 不 能 add Integer? 为 了 和 弄 清楚 
这 些 问题 ， 我 们 需要 了 解 Java 中 的 逆 变 和 协 变 及 泛 型 中 通配符 的 用 法 。 


List<? extends Number> list = new ArrayList<>(); 
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这 里 的 子 类 型 C 就 是 Number 类 及 其 子 类 (如 Number, Integer, Float 等 ) ， 表 示 的 
是 Number 类 或 其 子 类 。 父 类 下 就 是 上 界 通配符 ?extends Number. 
协 变 的 意义 如 图 8-6 所 示 。 


i List<?extends Number> ) 


List<Integer> 


图 8-6 协 变 


代码 示例 如 下 : 


List<? extends Number> list 


1 new ArrayList<Integer>(); 
List<? extends Number> list2 


new ArrayList<Float>(); 


但 是 这 里 不 能 向 et), list2 添加 除 null 以 外 的 任意 对 象 。 


list1.add (null); //ok 
list2.add(null) ; //ok 
listl.add (new Integer (1)); //error 


list2.add(new Float (1.1f)); //error 


List<Integer> 可 以 添加 Integer 及 其 子 类 ; List<Float> 可 以 添加 Float 及 其 子 类 ; 
List<Integer>、List<Float> 等 都 是 List<?extends Number> 的 子 类 型 。 

现在 问题 来 了 , 如 果 能 将 Float 的 子 类 添加 到 List<?extends Number> 中 , 也 能 将 Integer 
的 子 类 添加 到 List<?extends Number> 中 ， 那 么 List<?extends Number> 里 面 将 会 持 有 各 种 
Number 子 类 型 的 对 象 (如 Byte, Integer, Float, Double 等 ) 。 而 这 个 时 候 ， 当 我 们 再 使 
用 这 个 List 的 时 候 ， 元 素 的 类 型 就 会 混乱 ， 我 们 不 知道 哪个 元 素 是 Integer 或 者 Floats Java 
为 了 保护 其 类 型 一 致 ， 禁 止 向 List<? extends Number> 添 加 任意 Number 子 类 型 的 对 象 ， 不 
过 可 以 添加 空 对 象 null， 如 图 8-7 所 示 。 


List<? extends Number: List) = new ArrayList<Integer>(); 
List<? extends Number: List2 = new ArrayList<Float>(); 


List1.add(null); 
List2.add (null); 


List1.add(new Integer( value: AU: 
List2.add(new Float( value: 1.1f)); 


add (capture<? extends java.lang.Number>) in List cannot be applied 


to (java.lang.Float) 


图 8-7 禁止 向 List<? extends Number> 添 加 任意 Number 子 类 型 的 对 象 
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我 们 先 用 一 段 代 码 举例 : 

List<? super Number> list = new ArrayList<Object>(); 

这 里 的 子 类 型 C 是 “? super Number” , 父 类 型 F 是 Number 的 父 类 型 (如 Object 类 ) 。 
逆 变 的 意义 如 图 8-8 所 示 。 


| List<?super Number> | 


List<Object> 


图 8-8 is 


代码 示例 如 下 : 
List<? super Number> list3 = new ArrayList<Number> (); 
//Java 中 的 <? super Number> 通 配 符 

List<? super Number> list4 = new ArrayList<Object>(); 

list3.add(new Integer (3)); // 可 以 添加 Integer 类 型 的 元 素 

list4.add(new Integer (4) ); 

在 逆 变 类 型 中 ， 我 们 可 以 向 其 中 添加 元 素 。 例 如 ， 可 以 向 List<? super Number>list4 变 
量 中 添加 Number 及 其 子 类 对 象 。 


8.4.3 PECS 


现在 问题 来 了 : 我 们 什么 时 候 用 extends， 什 么 时 候 用 super 呢 ? 

Effective Java 给 出 了 答案 : PECS (Producer-Extends,Consumer-Super) 。 

Naftalin 与 Wadler 将 PECS 称 为 Get and Put Principle. 

在 java.util.Collections 的 copy0 方 法 中 (JDK1.7) 完美 地 诠释 了 PECS， 代 码 如 下 : 


public static <T> void copy(List<? super T> dest, List<? extends T> src) { 
int srcSize = src.size(); 
if (srcSize > dest.size()) 
throw new IndexOutOfBoundsException ("Source does not fit in dest"); 


if (srcSize < COPY THRESHOLD || 
(src instanceof RandomAccess && dest instanceof RandomAccess)) { 
for (int i=0; i<srcSize; i++) 
dest.set(i, src.get(i)); 
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} else { 
ListIterator<? super T> di=dest.listIterator();//in T, A dest 数据 
ListIterator<? extends T> si=src.listIterator();//out T， 读 取 src 数据 
for (int i=0; i<sreSize; i++) { 
di-next (); 
di.set (si.next()); 


} 


8.5 outT 5 inT 


正如 前 面 所 讲 的 ， 在 Java 泛 型 里 有 通配符 这 个 东西 ， 我 们 要 用 ?extends T 指定 类 型 参 
数 的 上 界 ， 用 ? super T 指定 类 型 参数 的 下 界 。 

而 Kotlin 抛弃 了 这 个 通配符 ， 直 接 实现 了 前 面 所 讲 的 PECS 的 规则 。Kotlin 中 引入 了 
投射 类 型 out T 代表 生产 者 对 象 ， 投 射 类 型 nT 代表 消费 者 对 象 ， 使 用 投射 类 型 (projected 
type)out T 和 iT 来 实现 与 ee 同样 的 功能 。 

下 面 通过 代码 示例 简单 讲解 一 

public static <T> void copy(List<? super T> dest, List<? extends T> src) { 


ListIterator<? super T> di=dest.listIterator(); //in T， 写 入 dest 数据 
ListIterator<? extends T> si=src.listIterator();//out T, iH src 数据 


} 


List<?super T>dest 是 消费 数据 的 对 象 , 数据 会 被 写 入 dest 对 象 中 , 这 些 数据 对 象 被 “ 消 
REFE” T Kotlin 中 Md inT) 。 

List<?extends T>sre 是 生产 提供 数据 的 对 象 。src 会 “ 产 出 ”数据 (Kotlin 中 叫 out T) 。 

在 Kotlin tH, 我们 把 只 能 保证 读 取 数 据 时 类 型 安全 的 对 象 叫做 生产 者 ， 用 out T 标记 ; 

把 只 能 保证 写 入 数据 安全 时 类 型 安全 的 对 象 叫 做 消费 者 ， 用 in TERE 

可 以 这 么 记 : 

out T 等 价 于 ? extends T; 

in T “(fF ? super T. 
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Java 和 Kotlin 的 泛 型 实现 , 都 是 采用 了 运行 时 类 型 擦 除 的 方式 。 也 就 是 说 , 在 运行 时 ， 
这 些 类 型 参数 的 信息 将 会 被 擦 除 。 

泛 型 是 在 编译 器 层次 上 实现 的 ， 生 成 的 class 字 节 码 文 件 中 是 不 包含 泛 型 中 的 类 型 信 
息 的 。 例 如 , 在 代码 中 定义 的 List<Objec 忆 和 List<String> 等 类 型 , 在 编译 之 后 都 会 变 成 List。 
JVM 看 到 的 只 是 List， 而 由 泛 型 附加 的 类 型 信息 对 JVM 来 说 是 不 可 见 的 。 
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关于 泛 型 的 很 多 奇怪 特性 都 与 这 个 类 型 擦 除 的 存在 有 关 ， 如 泛 型 类 并 没有 自己 独 有 的 
Class 类 对 象 。 比 如 Java 中 并 不 存在 List<String>.class 或 是 List<Integer>.class， 而 只 有 
List.class。 对 应 地 在 Kotlin 中 并 不 存在 MutableList<Fruit>::class, 而 只 有 MutableList:: class. 

类 型 擦 除 的 基本 过 程 也 比较 简单 : 

口 首先 ， 找 到 用 来 替换 类 型 参数 的 具体 类 。 这 个 具体 类 一 般 是 Object。 如 果 指 定 了 

类 型 参数 的 上 界 的 话 ， 则 使 用 这 个 上 界 。 
O 其 次 ， 把 代码 中 的 类 型 参数 都 替换 成 具体 的 类 。 同 时 去 掉 出 现 的 类 型 声明 ， 即 去 
掉 <> 的 内 容 。 例 如 ，TgetO0 就 变 成 了 Objectget0，List<String> 就 变 成 了 List. 

O 最 后 ， 根 据 需 要 生成 一 些 桥接 方法 。 这 是 由 于 擦 除了 类 型 之 后 的 类 可 能 缺少 某 些 

必须 的 方法 。 这 个 时 候 就 由 编译 器 来 动态 生成 这 些 方法 。 

当 了 解 了 类 型 控 除 机 制 之 后 ， 我 们 就 会 明白 是 编译 器 承担 了 全 部 的 类 型 检查 工作 。 编 
译 器 禁止 某 些 泛 型 的 使 用 方式 ， 也 正 是 为 了 确保 类 型 的 安全 性 。 
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泛 型 是 一 个 非常 有 用 的 东西 ， 尤 其 在 集合 类 中 我 们 可 以 发 现 大 量 的 泛 型 代码 。 有 了 泛 
型 ， 我 们 可 以 拥有 更 强大 、 更 安全 的 类 型 检查 ， 无 须 手 工 进行 类 型 转换 ， 并 且 能 够 开发 更 
加 通用 的 泛 型 算法 。 
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我 们 在 第 6 章 扩 展 函 数 与 属性 中 已 经 介绍 过 Kotlin 中 类 扩展 的 特性 。 使 用 Kotlin 的 扩 
展 函数 功能 ， 可 以 直接 为 String 类 实现 一 个 mc(O 函 数 ， 这 个 函数 把 字符 串 中 的 每 一 个 字符 
值 加 1。 


"abc" .inc() //bcd 


incO 扩 展 函 数 实现 如 下 : 


fun String.inc(): String { 
var result = "" 
this.map { result += it + 1 } 
return result 


} 

正 是 因为 有 了 强大 的 扩展 函数 ,我们 可 以 在 Java 类 库 的 基础 上 扩展 出 大 量 “ 看 似 Java 
类 中 的 原生 方法 ”。 而 实际 上 Kotlin 的 标准 库 kotlin-stdlib 中 大 量 的 API 都 是 通过 扩展 Java 
的 类 来 实现 的 。 

本 章 我 们 将 要 介绍 的 文件 IO 操作 、 正 则 表达 式 与 多 线程 等 相关 内 容 ， 都 是 Kotlin 通 
过 扩展 Java 已 有 的 类 来 实现 的 。 下 面 首先 来 介绍 文件 的 读 写 操作 。 


9.1 文件 IO 操作 


Kotlin UO 操作 的 API 在 kotlin.io 包 下 。Kotlin 的 原则 就 是 Java 已 经 有 的 好 用 的 类 就 
直接 使 用 ， 没 有 的 或 者 不 好 用 的 类 ， 就 在 原 有 类 的 基础 上 进行 功能 扩展 。 例 如 Kotlin 就 给 
File 类 写 了 扩展 函数 。 

Kotlin 为 java.io.File 类 扩展 了 大 量 好 用 的 扩展 函数 ， 这 些 扩展 函数 都 在 kotlin\io\File 
ReadWrite kt 源 代码 文件 中 ， 具 体 将 在 后 面 介绍 。 

同时 ，Kotlin 也 针对 InputStream, OutputStream 和 Reader 等 都 做 了 简单 的 扩展 。 它 们 
主要 在 kotlin\io\IOStreams.kt. kotlin\io\ReadWrite.kt 源 代码 文件 中 。 

Koltin 的 序列 化 直接 采用 了 Java 序列 化 类 的 类 型 别名 : 


internal typealias Serializable = java.io.Serializable 


下 面 来 简单 介绍 一 下 Kotlin 文件 的 读 写 操作 。Kotlin 中 常用 的 文件 读 写 API 如 表 9-1 
所 示 。 
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表 9-1 文件 读 写 API 
函数 签名 
File.readText(charset: Charset = Charsets.UTF 8): String 
File.readLines(charset: Charset = Charsets.UTF 8): List 

File.readBytes(): ByteArray 
File.writeText(text: String, charset: Charset = 
Charsets.UTF_8): Unit 

File.writeBytes(array: ByteArray): Unit 
File.appendText(text: String, charset: Charset = 
Charsets.UTF_8): Unit 
File.appendBytes(array: ByteArray): Unit 


功能 说 明 
读 取 该 文件 的 所 有 内 容 作 为 一 个 字符 串 返 回 
读 取 该 文件 的 每 一 行内 容 ， 存 入 一 个 List 返 
读 取 文件 所 有 内 容 以 ByteAmay 的 方式 返 区 


覆盖 写 入 text 字符 串 到 文件 中 

覆盖 写 入 ByteAmay 字 节 流 数组 

在 文件 末尾 追加 写 入 text FHE 

在 文件 末尾 追加 写 入 ByteArray 字 节 流 数组 


Ea 


9.1.1 读 文件 


Kotlin 中 提供 了 使 用 简单 的 文件 读 函 数 ， 下 面 分 别 介绍 。 
1. readText: 获 取 文件 全 部 内 容 字 符 串 


如 果 简 单 读 取 一 个 文件 ,可 以 使 用 readText0 方 法 , 它 直 接 返 回 整 个 文件 内 容 。 代 码 示 
例如 下 : 
fun getFileContent (filename: String): String { 
val f = File(filename) 
return f. readText (Charset. forName ("UTF-8")) // 获 取 整 个 文件 的 内 容 ， 以 UTF-8 
编码 格式 的 字符 串 
} 
我 们 直接 使 用 File 对 象 来 调用 readText0 函 数 即 可 获得 该 文件 的 全 部 内 容 ， 它 返回 一 
个 字符 串 。 如 果 指 定 字符 编码 ， 可 以 通过 传 入 参数 Charset 来 指定 ， 默 认 是 UTF-8 编码 。 


2. readLines: 获 取 文 件 每 行 的 内 容 


如 果 想 要 获得 文件 中 每 行 的 内 容 ， 可 以 简单 通过 split("\n") 来 获得 一 个 每 行内 容 的 数 
组 。 我 们 也 可 以 直接 调用 Kotlin 封装 好 的 readLines0 函 数 ， 获 得 文件 中 每 行 的 内 容 。 
readLines() 疯 数 返回 一 个 持 有 每 行内 容 的 字符 串 Listo 
fun getFileLines (filename: String): List<String> {// 返 回 一 个 持 有 这 个 文件 中 每 
行内 容 的 字符 串 List 


return File (filename) .readLines (Charset .forName ("UTF-8")) 


3. readBytes: 读 取 字 节 流 数组 


如 果 希 望 直接 操作 文件 的 字 节 数组 ， 可 以 使 用 readBytes0 函 数 。 


// 读 取 为 bytes 数组 
val bytes: ByteArray = f.readBytes() // 返 回 这 个 文件 的 字 节 数组 
println(bytes.joinToString (separator = " ")) 
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// 与 Java 互 操作 ， 直 接 调用 Java 中 的 InputStream 和 InputStream 类 
val reader: Reader = f.reader() 

val inputStream: InputStream = f.inputStream() 

al bufferedReader: BufferedReader = f.bufferedReader () 


4. bufferedReader: 获取 文件 的 方法 签名 
获取 文件 的 bufferedReader() 方 法 签名 : 


fun File.bufferedReader ( 
charset: Charset = Charsets.UTF 8, 
bufferSize: Int = DEFAULT BUFFER SIZE 
): BufferedReader 


91.2 Bxtt 


使 用 Kotlin 扩展 的 函数 ， 写 入 文件 也 变 得 相当 简单 。 与 读 取 文 件 类 似 ， 我 们 可 以 写 入 
FRP, 也 可 以 写 入 字 节 流 , 还 可 以 直接 调用 Java 的 Writer 或 者 OutputStream 类 。 写 文件 
通常 分 为 覆盖 写 〈 一 次 性 写 入 ) 和 追加 写 两 种 情况 。 

1. writeText 覆盖 写 文件 


我 们 使 用 writeText0 函 数 直接 向 一 个 文件 中 写 入 字符 串 text 的 内 容 : 


fun writeFile(text: String, destFile: String) { 
val f = File(destFile) 
if (!f-.exists()) { 
£.createNewFile () 
} 
f.writeText (text, Charset.defaultCharset()) // 获 闵 写 入 字符 串 text 的 内 容 
} 


其 中 ，destFile 参数 是 目标 文件 名 〈 带 目录 ) o 
2. appendFile: 末尾 追加 写 文件 
使 用 appendFile0) 函 数 向 一 个 文件 的 末尾 追加 写 入 内 容 text。 


fun appendFile(text: String, destFile: String) { 
val f = File(destFile) 
if (!f.exists()) { 
£.createNewFile () 
} 
E. appendText (text, Charset.defaultCharset()) // 追 加 写 入 内 容 text 


3. appendBytes: 追加 写 入 字 节 数组 


追加 字 节 数组 到 该 文件 中 方法 签名 : 


fun File.appendBytes (array: ByteArray) 
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4. bufferedWriter: 获取 缓存 区 写 对 象 


获取 该 文件 的 bufferedWriter() 方 法 签名 : 


fun File.bufferedWriter ( 
charset: Charset = Charsets.UTF_8, 
bufferSize: Int = DEFAULT_BUFFER_SIZE 
): BufferedWriter 


DR: 关于 Kotlin 对 File 的 扩展 函数 API 文 档 ， 可 以 参考 https://kotlinlang.org/api/latest/ 
jvn7/stdlib/kotlin.i0/java.io.-file/index.html. 


9.1.3 遍历 文件 树 


Kotlin 中 提供 了 方便 的 功能 来 遍历 文件 树 。 
1. walk 函 数 : 遍历 文件 树 
下 面 的 例子 遍历 了 指定 文件 夹 下 的 所 有 文件 。 


fun traverseFileTree(filename: String) { 
val f = File (filename) 
val fileTreeWalk = f.walk() 
fileTreeWalk.iterator().forEach { println(it.absolutePath) } 
// 遍 有 历 指定 文件 夹 下 的 所 有 文件 


测试 代码 如 下 : 


KFileUtil.traverseFileTree(".") 


上 面 的 测试 代码 将 输出 当前 目录 下 的 所 有 子 目录 及 其 文件 。 我 们 还 可 以 遍历 当前 文件 
下 所 有 的 子 目 录 文 件 ， 将 其 存 入 一 个 Iterator 中 : 


fun getFileIterator (filename: String): Iterator<File> { 
val f = File(filename) 
val fileTreeWalk = f.walk() 
return fileTreeWalk.iterator () 


} 
我 们 遍历 当前 文件 下 的 所 有 子 目 录 文 件 ， 还 可 以 根据 条 件 进行 过 滤 ， 并 把 结果 存 入 一 
个 Sequence 中 : 


fun getFileSequenceBy (filename:String,p: (File) ->Boolean) :Sequence<File>{ 
val f = File(filename) 
return f.walk().filter(p) //HUBATE p 过 滤 

} 


遍历 文件 树 需 要 调用 扩展 方法 walk0， 它 会 返回 一 个 FileTreeWalk 对 象 ， 它 有 一 些 方 
法 用 于 设置 遍历 方向 和 深度 ， 详 情 参 见 FileTreeWalk API 文档 说 明 。 
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QHR: FileTreeWalk API 文档 链接 地 址 是 https://kotlinlang org/api/latest/jvm/stdlib/kotlin.io/ 
-file-tree-walk/. 


2. 递归 复制 文件 


复制 该 文件 或 者 递归 复制 该 目录 及 其 所 有 子 文件 到 指定 路 径 下 ， 如 果 指 定 路 径 下 的 文 
件 不 存在 ， 会 自动 创建 。 
copyRecursively 函数 笃 名 : 


fun File.copyRecursively ( 
target: File, // 目 标 文件 
overwrite: Boolean = false, //Efifim. true: 覆盖 之 前 先 删除 原来 的 文件 
onError: (File, IOException) -> OnErrorAction = { _, exception -> throw 
exception } // 错 误 处 理 


) : Boolean 


9.2 网 络 IO 


Kotlin 为 Java SDK 中 的 java.net.URL 类 增加 了 两 个 扩展 方法 , 即 readBytes 和 readText 
(Kotlin 对 Java 已 有 的 API 做 了 许多 这 样 的 功能 扩展 与 封装 ) 。 我 们 可 以 方便 地 使 用 这 两 
个 方法 配合 正则 表达 式 实现 网 络 怜 虫 的 功能 。 

下 面 我 们 简单 写 几 个 函数 实例 。 
根据 URL 获取 该 URL 的 响应 HTML 函数 : 
fun getUrlContent (url: String): String { 
return URL(url) .readText (Charset .defaultCharset () ) // 获 取 该 URL 的 响应 HTML 文本 
D 
根据 URL 获取 该 URL 响应 比特 数组 函数 : 


fun getUrlBytes(url: String): ByteArray { 
return URL(url) .readBytes () // 获 取 该 URL 的 响应 ByteArray 
把 URL 响应 字 节 数 组 写 入 文件 中 : 


fun writeUrlBytesTo(filename: String, url: String) { 
val bytes = URL(url) .readBytes () 
File (filename) .writeBytes (bytes) // 写 入 文件 

} 


下 面 的 例子 简单 地 获取 了 百度 首页 的 源 代码 。 

getUrlContent ("https://www.baidu.com") 

下 面 的 例子 根据 URL 来 获取 一 张 图 片 的 比特 流 , 然后 调用 readBytes() 方 法 读 取 字 节 流 
并 写 入 文件 中 。 


writeUrlBytesTo ("图 片 .jpg"， 
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"http://n.sinaimg.cn/default/4 img/uplaod/3933d981/20170622/2fIE-fyhfxp 
h6601959.jpg") 


在 项 目 相 应 文件 夹 下 ， 可 以 看 到 下 载 好 的 “图 片 jpg”。 
9.3 执行 Shell 命令 


我 们 使 用 Groovy 语言 的 文件 IO 操作 感觉 非常 好 用 ， 例 如 : 
package com.easy.kotlin 


import org.junit.Test 
import org.junit.runner.RunWith 
import org.junit.runners.JUnit4 


@RunWith (JUnit4) 
class ShellExecuteDemoTest { 
@Test 
def void testShellExecute() { 
def p = "Is -R".execute() //Groovy 中 的 shell 执行 函数 
def output = p.inputStream.text 
println (output) 
def fname = "我 图 .url" 
def f = new File(fname) 
def lines = f.readLines() 
lines. forEach ({ 
println (it) 
}) 
println(f.text) 


} 


Kotlin 中 的 文件 VO 和 网 络 VO 操作 与 Groovy 一 样 简单 。 另 外 ， 从 上 面 的 代码 中 可 以 
看 到 使 用 Groovy 执行 终端 命令 非常 简单 


def p = "ls -R".execute() 
def output = p.inputStream.text 


在 Kotlin 中 ， 目 前 还 没有 对 String 类 和 Process 类 扩展 这 样 的 函数 。 其 实 扩展 这 样 的 
函数 非常 简单 ， 我 们 完全 可 以 自己 去 扩展 。 
首先 我 们 来 扩展 String 的 execute() 函 数 。 


fun String.execute(): Process { // 给 String Y È execute () 函数 
val runtime = Runtime.getRuntime() 
return runtime.exec (this) 


} 
然后 给 Process 类 扩展 一 个 text0 函 数 。 


fun Process.text(): String { // 给 Process 类 扩展 text () 函数 
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var output = 


// 输 出 Shell 执行 的 结果 
val inputStream = this.inputStream 
val isr = InputStreamReader (inputStream) 
val reader = BufferedReader (isr) 
var line: String? = "" 
while (line != null) { 
line = reader.readLine () 
output += line + "\n" 


} 


return output 


} 


完成 了 上 面 两 个 简单 的 扩展 函数 之 后 ， 就 可 以 在 下 面 的 测试 代码 中 像 Groovy 一 样 执 


行 终端 命令 了 : 


val p = "ls -al".execute() 


val exitCode = p.waitFor() 


val text 


= p.text () 


println (exitCode) 
println (text) 


实际 上 , 通过 前 面 多 个 实例 的 学 习 , 我 们 可 以 看 出 Kotlin 的 扩展 函数 相当 实用 。Kotlin 
语言 本 身 提供 的 SDK 标准 库 API 中 其 实 也 大 量 使 用 了 扩展 功能 。 


94 正则 表达 式 


我 们 在 Kotlin 中 除了 仍然 可 以 使 用 Java 中 的 Pattern, Matcher 等 类 之 外 ，Kotlin 还 提 
供 了 一 个 正则 表达 式 类 kotlin\textregex\Regex.kt， 我 们 通过 Regex 的 构造 函数 来 创建 一 个 


正则 表达 式 。 


9.4.1 构造 Regex 表达 式 


使 用 Regex 构造 函数 如 下 : 


val rl 
val r2 


Regex ("[a-z]+") // 创 建 一 个 Regex 对 象 ， 匹 配 的 正则 表达 式 是 [a-z]+ 
Regex ("[a-z]+", RegexOption.IGNORE_CASE) 


其 中 的 匹配 选项 RegexOption 是 直接 使 用 的 Java 类 Pattern 中 的 正则 匹配 选项 。 
使 用 String 的 toRegex0 扩 展 函数 如 下 : 


val r3 = 


"[A-Z]+".toRegex() // 直 接 使 用 Kotlin 中 给 String 扩展 的 toRegex 函数 


9.4.2 Regex 函数 


Regex 里 面 提供 了 丰富 的 简单 而 实用 的 函数 ， 如 表 9-2 所 示 。 
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表 9-2 Regex 函 数 
函数 名 称 


matches(input: CharSequence): Boolean 


功能 说 明 
输入 字符 串 全 部 匹配 
输入 字符 串 至 少 有 一 个 匹配 
输入 字符 串 全 部 匹配 , 返回 一 个 匹配 结果 对 象 
把 输入 字符 串 中 匹配 的 部 分 替换 成 
replacement 的 内 容 
把 输入 字符 串 中 匹配 到 的 值 ,用 函数 transform 
映射 之 后 的 新 值 替 换 
返回 输入 字符 串 中 第 一 个 匹配 的 值 


返回 输入 字符 串 中 所 有 匹配 的 值 MatchResult 
的 序列 


containsMatchIn(input: CharSequence): Boolean 
matchEntire(input: CharSequence): MatchResult? 
replace(input: CharSequence, replacement: String): 
String 

replace(input: CharSequence, transform: (MatchResult) 
-> CharSequence): String 

find(input: CharSequence, startIndex: Int = 0): 
MatchResult? 

findAll(input: CharSequence, startIndex: Int = 0): 
Sequence 


下 面 分 别 对 表 中 列举 的 函数 给 出 简单 示例 。 
1. matches() 函 数 
如 果 输 入 的 字符 串 全 部 匹配 正则 表达 式 则 返回 tue， 否则 返回 false. 


>>> val rl = Regex("[a-z]+") 
>>> rl.matches ("ABCzxc") // 其 中 大 写 的 ABC 不 匹配 ， 所 以 返回 false 
false 


>>> val r2 = Regex("[a-z]+",RegexOption. IGNORE CASE) // 正 则 表达 式 ， 忽 略 大 小 写 
>>> r2.matches("ABCzxc") ”// 忽 略 大 小 写 ， 满足 正则 表达 式 ， 所 以 返回 true 


true 
>>> val r3 = "[A-Z]+".toRegex() 
>>> r3.matches ("GGMM") // 都 是 大 写字 母 ， 满 足 [A-Z] 正则 表达 式 ， 所 以 返回 true 


true 


2. containsMatchIn() 3X 


如 果 输 入 字符 串 中 至 少 有 一 个 匹配 就 返回 tue， 如 没有 匹配 就 返回 false. 


>>> val re = Regex("[0-9]+") 
>>> re.containsMatchIn ("012Abc") // 包 含 满足 条 件 的 就 返回 true, 012 满足 [0-9]+ 正 
则 匹配 ， 所 以 返回 true 


true 
>>> re.containsMatchIn ("Abc")// 没 有 任何 字符 满足 [0-9]+ 正 则 表达 式 ， 所 以 返回 false 
false 


3. matchEntire() 函 数 


如 果 输 入 字符 串 全 部 匹配 正则 表达 式 则 返回 一 个 MatcherMatchResult 对 象 ， 否 则 返 
[=] null. 

>>> val re = Regex ("[0-9]+") 

>>> re.matchEntire ("1234567890") // 全 部 满足 匹配 条 件 


kotlin.text .MatcherMatchResult@34d713a2 
>>> re.matchEntire ("1234567890!") 
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null 
我 们 可 以 访问 MatcherMatchResult 的 value 属性 来 获得 匹配 的 值 。 


>>> re.matchEntire("1234567890")?.value 
1234567890 


由 于 matchEntire() 函 数 的 返回 是 MatchResult? 可 空 对 象 , 所 以 这 里 使 用 了 安全 调用 符 


Wi “gn | 


4. replace(input: CharSequence, replacement: String): String 2X 


把 输入 字符 串 中 匹配 的 部 分 替换 成 replacement 的 内 容 。 
>>> val re = Regex("[0-9]+") 


>>> re.replace ("12345XYZ", "abcd") 
abcdXYZ 


我 们 可 以 看 到 ，12345XYZ 中 12345 是 匹配 正则 表达 式 [0-9]+ 的 内 容 ， 它 被 奉 换 成 了 
abcd。 


5. replace(input: CharSequence, transform: (MatchResult) -> CharSequence):String 函 数 


replace() 函 数 签名 如 下 : 
replace (input:CharSequence, transform: (MatchResult) ->CharSequence) :String 


replace() 函 数 的 功能 是 把 输入 字符 串 中 匹配 到 的 值 , 用 函数 transform0) 映 射 之 后 的 新 值 
进行 替换 。 

>>> val re = Regex("[0-9]+") 

>>> re.replace("9XYZ8", { (it.value.toInt() * it.value.toInt()).toString() }) 

81XYZ64 

可 以 看 到 ,9XYZ8 中 数字 9 和 8 是 匹配 正则 表达 式 [0-9]+ 的 内 容 ,它们 分 别 被 transformmO 
函数 映射 (it.value.toIntO*it.value.toInt0).toString0 的 新 值 81 和 64 所 替换 。 


6. find() 函 数 
返回 输入 字符 串 中 第 一 个 匹配 的 MatcherMatchResult 对 象 。 


>>> val re = Regex("[0-9]+") 

>>> re.find("123XYZ987abcd7777") 
kotlin.text.MatcherMatchResult@4d4436d0 
>>> re.find("123XYZ987abcd7777") ?.value 
123 


7. findAll() 函 数 


返回 输入 字符 串 中 所 有 匹配 值 的 MatchResult 的 序列 。 
>>> val re = Regex("[0-9]+") 


>>> re.findAll ("123XYZ987abcd7777") 
kotlin.sequences .GeneratorSequence@f245bdd 
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我 们 可 以 通过 forEach 循环 遍历 所 有 匹配 的 值 : 


>>> re.findAll ("123XYZ987abcd7777") .forEach{println (it.value)} 
123 

987 

TETI 


9.4.3 使 用 Java 的 正则 表达 式 类 


除了 前 面 Kotlin 提供 的 函数 之 外 ， 在 Kotlin 中 仍然 可 以 使 用 Java 正则 表达 式 的 API. 


val re = Regex("[0-9]+") 
val p = re.toPattern() 
val m = p.matcher ("888ABC999") 
while (m.find()) { 
val d = m.group() 
printin (d) 
} 
上 面 的 代码 运行 后 输出 如 下 : 


888 
999 


95 多 线程 编程 


Kotlin 中 没有 synchronized、volatile 关键 字 。Kotlin 的 Any 类 似 于 Java 的 Object， 但 
是 没有 waitO、notifyO0 和 notifyAll0 方 法 。 

那么 并 发 如 何在 Kotlin 中 工作 呢 ? 放心 ，Kotlin 既然 是 站 在 Java 的 肩膀 上 ， 当 然 少 
不 了 对 多 线程 编程 的 支持 一 一 Kotlin 通过 封装 Java 中 的 线程 类 ， 简 化 了 我 们 的 编码 。 同 时 
我 们 也 可 以 使 用 一 些 特 定 的 注解 ， 直 接 使 用 Java 中 的 同步 关键 字 等 。 下 面 简单 介绍 一 下 使 
用 Kotlin 进行 多 线程 编程 的 相关 内 容 。 


9.5.1 创建 线程 
我 们 在 Java 中 通常 有 两 种 方法 创建 线程: 


扩展 Thread 类 或 者 进行 实例 化 并 通过 构造 函数 传递 一 个 Runnable. 因为 我 们 可 以 很 容 
易 地 在 Kotlin 中 使 用 Java 类 ， 所 以 这 两 个 方式 都 可 以 使 用 。 


1. 使 用 对 象 表 达 式 创建 


object : Thread() { //object 对 象 表达 式 
override fun run() { 
Thread.sleep (3000) 
println ("A 使 用 Thread 对 象 表达 式 : ${Thread.currentThread() in) 
} 
}.start() 
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此 代码 使 用 Kotlin 的 对 象 表 达 式 创建 一 个 匿名 类 并 履 盖 mn0 方 法 。 


2. 使 用 Lambda 表 达 式 


下 面 是 如 何 将 一 个 Runnable 传递 给 一 个 新 创建 的 Thread 实例 : 


Thread({ //Lambda 表达 式 
Thread.sleep (2000) 


println("B 使 用 Lambda 表达 式 : ${Thread.currentThread () ln) 


start () 


我 们 在 这 里 看 不 到 Runnable, 在 Kotlin 中 可 以 直接 使 用 上 面 的 Lambda 表达 式 来 表达 。 


还 有 更 简单 的 方法 吗 ? 且 看 下 文 解 说 。 
3. 使 用 Kotlin 封 装 的 Thread() 函 数 
例如 ， 我 们 写 了 下 面 一 段 线程 的 代码 : 


val t = Thread({ 
Thread.sleep (2000) 


println("C 使 用 Lambda #i&st:${Thread.currentThread () }") 


}) 


t.isDaemon = false 


t.name = "CThread" 
t.priority = 3 
t.start() 


后 面 的 四 行 可 以 说 是 样板 化 的 代码 。 在 Kotlin 中 把 这 样 的 操作 封装 简化 了 。 


thread(start = true, isDaemon = false, name "DThread", priority = 3) { 


Thread.sleep (1000) 


printin("D 使 用 Kotlin 封装 的 函数 thread(): ${Thread.currentThread() }") 


} 


这 样 的 代码 显得 更 加 精简 整洁 了 。 事 实 上 ，Thread0 函 数 就 是 对 我 们 编程 实践 中 


用 到 的 样板 化 的 代码 进行 了 抽象 封装 ， 它 的 实现 如 下 : 


public fun thread(start: Boolean = true, 
contextClassLoader: 


ClassLoader? = null, name: String? = null, priority: Int 


-> Unit): Thread { 
val thread = object : Thread() { 
public override fun run() { 
block () 
} 


if (isDaemon) 
thread.isDaemon = true 
if (priority > 0) 
thread.priority = priority 
if (name != null) 
thread.name = name 
if (contextClassLoader != null) 


thread.contextClassLoader = contextClassLoader 


if (start) 
thread.start () 
return thread 


经 党 
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| 


这 只 是 一 个 使 用 非常 方便 的 包装 函数 ， 简 单 、 实 用 。 从 上 面 的 例子 中 可 以 看 出 ，Kotlin 
通过 扩展 Java 的 线程 API， 简 化 了 样板 代码 。 


95.2 同步 方法 和 块 


synchronized 不 是 Kotlin 中 的 关键 字 ， 它 替换 为 @Synchronized 注解 。Kotlin 中 的 同步 
方法 的 声明 如 下 : 


@Synchronized fun appendFile(text: String, destFile: String) { 
val f = File(destFile) 
if (!f-exists()) { 
£.createNewFile() 
} 


f.appendText (text, Charset.defaultCharset () ) 
} 


@Synchronized 注解 与 Java 中 的 synchronized 具有 相同 的 效果 ， 即 会 将 JVM 方法 标 
记 为 同步 。 
对 于 同步 块 ， 我 们 使 用 synchronized0 函 数 ， 它 使 用 锁 作 为 参数 : 
fun appendFileSync(text: String, destFile: String) { 
val f = File(destFile) 
EE (E Ee Eich 
£.createNewFile() 


} 


synchronized (this) { 


f.appendText (text, Charset.defaultCharset () ) 
} 
j; 


synchronized() 函 数 与 Java 的 语法 基本 一 样 ， 大 家 用 起 来 会 觉得 很 熟悉 。 


9.5.3 可 变 字段 


同样 地 ，Kotlin 中 没有 volatile 关键 字 ， 但 是 有 @Volatile 注解 。 


@Volatile private var running = false 
fun start() { 
running = true 
thread(start = true) { 
while (running) { 
println ("Still running: ${Thread.currentThread() ln) 


} 
} 
fun stop() { 


running = false 


println("Stopped: ${Thread.currentThread()}") 
} 


@Volatile 会 将 JVM 备份 字段 标记 为 volatile。 
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当然 ， 在 Kotlin 中 还 有 更 好 用 的 协 程 并 发 库 ， 在 代码 工程 实践 中 ， 可 以 根据 实际 情况 
自由 选择 。 


96 本 章 小 结 


Kotlin 是 一 门 工程 实践 性 很 强 的 语言 ， 从 本 章 介绍 的 文件 TO、 正 则 表达 式 及 多 线程 冬 
内 容 中 ,我 们 可 以 领会 到 Kotlin 的 基本 原则 : 充分 使 用 己 有 的 Java 生态 库 ， 在 此 基础 之 
上 进行 更 加 简单 、 实 用 的 扩展 ， 大 大 提升 程序 员 的 工作 效率 。 从 本 章 的 介绍 中 我 们 也 体会 
到 了 Kotlin 编程 中 的 极 简 理念 一 一 不 断 地 抽象 、 封 装 、 扩 展 ， 使 之 更 加 简单 、 实 用 。 

本 章 示 例 代 码 地 址 https://github.com/EasyKotlin/chapter15_file_io. 

另外 ， 笔 者 综合 本 章 相关 的 的 内 容 ， 使 用 Kotlin + Spring Boot 写 了 一 个 简单 的 图 片 + 
SCH MEH Web 应 用 ， 感 兴趣 的 读者 可 参考 源码 : https://github.com/AK-47-D/cms-spider。 
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使 用 DSL 的 编程 风格 ， 可 以 让 程序 更 加 简单 、 和 干净、 直观。 当然 ， 我 们 也 可 以 创建 自 
己 的 DSL。 相 对 于 传统 的 API，DSL 更 加 富有 表现 力 ， 更 符合 人 类 的 语言 习惯 。 

本 章 就 让 我 们 一 起 来 学 习 Kotlin 中 DSL 的 相关 内 容 。 本 章 首 先 会 介绍 什么 是 DSL， 
然后 简单 介绍 Kotlin DSL 设计 中 的 特性 支持 , 最 后 给 出 一 个 HTTP AJAX 请 求 的 DSL 实现 
的 完整 案例 。 


10.1 什么 是 DSL 


DSL (Domain-Specific Language， 领 域 特定 语言 ， 指 的 是 专注 于 特定 问题 领域 的 计算 
机 语言 。 不 同 于 通用 的 计算 机 语言 (GPL) ， 领 域 特定 语言 只 用 在 某 些 特定 的 领域 。 

DSL 语言 能 让 我 们 以 一 种 更 优雅 、 更 简洁 的 方式 来 表达 和 解决 领域 问题 。 之 所 以 能 够 
这 样 ， 是 因为 DSL 语言 刚好 能 够 用 于 这 个 特定 的 解决 领域 中 存在 的 模式 。 

DSL 简单 讲 就 是 对 一 个 特定 问题 〈 受 限 的 表达 能 力 ) 的 方案 模型 更 高 层次 的 抽象 表达 
(领域 语言 》， 使 其 更 加 简单 易 懂 (容易 理解 的 语义 及 清晰 的 语义 模型 〉。 

DSL 只 是 问题 解决 方案 模型 的 外 部 封装 ， 这 个 模型 可 能 是 一 个 API 库 ， 也 可 能 是 一 个 
完整 的 框架 等 。DSL 提供 了 思考 特定 领域 问题 的 模型 语言 ， 这 使 得 我 们 可 以 更 加 简单 、 高 
效 地 解决 问题 。DSL 聚焦 一 个 特定 的 领域 ， 简 单 易 懂 ， 功 能 极 简 但 完备 ， 更 加 方便 我 们 理 
解 和 使 用 模型 。 

比如 用 来 显示 网 页 的 HTML 语言 ， 在 Kotlin 生态 中 有 个 kotlinx html 可 在 Web 应 用 
程序 中 用 于 构建 HTML 的 DSL。 它 可 以 作为 传统 模板 系统 (如 JSP, FreeMarker 等 ) 的 替 
代 品 。 

kotlinx.html 分 别提 供 了 kotlinx-html-jvm 和 kotlinx-html-js 库 的 DSL， 用 于 在 JVM 和 
浏览 器 (或 其 他 JavaScript 引擎 ) 中 直接 使 用 Kotlin 代码 来 构建 HTML， 直 接 解放 了 原 有 
的 HTML 标签 式 的 前 端 代码 。 这 样 ， 我 们 也 可 以 使 用 Kotlin 来 写 传统 意义 上 的 HTML 页 
面 了 。Kotlin Web 编程 将 会 更 加 简单 纯净 。 


QER: 更 多 关于 kotlinx html 的 相关 内 容 ， 可 以 参考 它 的 GitHub 地 址 https://github.com/ 
Kotlin/kotlinx html. 


更 加 典型 的 例子 是 用 于 替代 Android 开发 中 布局 XML 文件 的 DSL 框架 Anko， 它 使 
用 基于 Kotlin 的 DSL 来 声明 Android UI 组 件 ， 而 不 是 传统 的 XML 。 
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在 Android 中 使 用 下 面 这 样 嵌 套 DSL 风格 的 代码 来 蔡 代 XML 式 风格 的 视图 文件 : 


DI 
//AnkoContext 
verticalLayout { 
padding = dip(30) 
var title = editText { 
//editText 视图 
id = R.id.todo title 
hintResource = R.string.title hint 


} 
var content = editText { 
id = R.id.todo content 
height = 400 
hintResource = R.string.content hint 
} 
button { 


//button 视图 
id = R.id.todo add 
textResource = R.string.add todo 
textColor = Color.WHITE 
setBackgroundColor (Color. DKGRAY) 
onClick í -> createTodoFrom(title, content) } 
} 
} 
} 
相 比 XML 风格 的 DSL (XML 本 质 上 讲 也 是 一 种 DSL) ， 使 用 原生 的 编程 语言 《如 
Kotlin) DSL 风格 更 加 简单 、 干 净 ， 也 更 加 自由 、 灵 活 。 
DSL 有 内 部 DSL 与 外 部 DSL 之 分 。 例 如 Gradle, Anko 等 都 是 使 用 通用 编程 语言 (Java 


和 Kotlin) 创建 的 内 部 DSL. 
10.1.1 内 部 DSL 


内 部 DSL 是 指 与 项 目 中 使 用 的 通用 目的 编程 语言 Java, CH Ruby) 紧密 相关 的 一 
类 DSL。 它 基于 通用 编程 语言 实现 。 

例如 , Rails 框架 被 称 为 基于 Ruby 的 DSL, 用 于 管理 Ruby 开发 的 Web 应 用 程序 。Rails 
之 所 以 被 称 为 DSL， 原 因 之 一 在 于 Rails 应 用 了 一 些 Ruby 语言 的 特性 ， 使 得 基于 Rails 编 
程 看 上 去 与 基于 通用 目的 的 Ruby 语言 编程 并 不 相同 。 

根据 Martin Fowler 和 Eric Evans 的 观点 ， 框 架 或 者 程序 库 的 API 是 否 满 足 内 部 DSL 
的 关键 特征 之 一 就 是 它 是 否 有 一 个 流畅 (fluent) 的 接口 。 这样 就 能 够 用 短小 的 对 象 表达 式 
去 组 织 一 个 原本 很 长 的 表达 式 ， 使 它 读 起 来 更 加 自然 。 


10.1.2 外 部 DSL 


我 们 已 经 知道 , “内 部 DSL” 就 是 利用 编程 语言 自 带 的 语法 结构 定义 出 来 的 DSL， 也 
叫做 “内 内 DSL”。 外 部 DSL 是 从 零 开始 构建 的 语言 ， 需 要 实现 语法 分 析 器 等 。 通 常情 
况 下 ， 我 们 只 需要 实现 内 嵌 式 DSL, 因为 它 更 容易 构建 ， 并 具有 很 多 与 外 部 DSL 相同 的 
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优势 。 
外 部 DSL 与 通用 编程 语言 (GPL) 类 似 ， 但 是 外 部 DSL 更 加 专注 于 特定 领域 。 创 建 


外 部 DSL 和 创建 一 种 通用 的 编程 语言 的 过 程 是 相似 的 ， 它 可 以 是 编译 型 或 者 解释 型 。 


QER: 关于 DSL 的 详细 介绍 可 以 参考 《领域 特定 语言 》 (Martin Fowler) 这 本 书 。 


10.2 Kotlin 的 DSL 特性 支持 


许多 现代 语言 为 创建 内 部 DSL 提供 了 一 些 先进 的 方法 , Kotlin 也 不 例外 。 在 Kotlin 中 
创建 DSL， 一 般 主 要 使 用 下 面 3 个 特性 : 

口 扩展 函数 、 扩 展 属性 ; 

口 带 接收 者 的 Lambda 表达 式 ( 高 阶 函数 〉; 

O invoke 函数 调用 约定 。 

例如 上 面 嵌 套 DSL 风格 的 UI 示例 代码 的 简单 说 明 ， 如 表 10-1 所 示 。 


表 10-1 赃 套 DSL 风 格 的 UI 代码 说 明 


函 数 名 函数 签名 备注 说 阴 
Ss android.support.v4.app.Fragment 的 扩展 函数 ; 
fun Fragment.UI(init: AnkoContext.() -> AS init 是 一 个 带 接收 者 的 函数 字面 值 ， 我 


UI 
i i 们 直接 传 入 的 是 一 个 Lambda 表达 式 
inline fun ViewManager.verticalLayout 

verticalLayout | (init: _LinearLayout.() -> Unit): Linear | android. view. ViewManager 的 扩展 函数 


Layout 
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单 讲 一 下 Kotlin 中 的 invoke 操作 符 函 数 。 

在 前 面 的 集合 类 章节 中 ,我 们 知道 Kotlin 中 使 用 下 标 运算 符 foo[x] 来 等 价 调用 foo. get(x) 
操作 符 函 数 。 同 样 地 ， 关 于 invoke 操作 符 函 数 调 用 有 一 个 类 似 的 约定 。 我 们 知道 ， 对 一 个 
函数 predicate:(T)->Boolean, 可 以 直接 调用 predicate(element)， 这 样 的 代码 实例 可 以 在 List 
的 扩展 函数 filterTo 中 看 到 : 


public inline fun <T，C : MutableCollection<in T>> Iterable<T>.filterTo 


(destination: C, predicate: (T) -> Boolean): C { 
for (element in this) if (predicate(element)) destination.add(element) 


return destination 


$ 

在 Kotlin 中 , 可 以 将 foo.invoke0 简 写成 foo0, 在 Kotlin 中 操作 符 是 可 以 重 载 的 ，“0?” 
操作 符 对 应 的 就 是 类 的 重 载 操作 符 函 数 invoke， 即 此 处 的 predicate:(T)->Boolean) 函 数 的 
调用 : 

predicate (element) 

等 价 于 


“ls 
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predicate. invoke (element) 


上 面 的 是 函数 类 型 对 象 mvoke 函数 的 例子 。 而 实际 上 在 Kotlin H, 在 类 的 对 象 实例 中 
也 可 以 像 函数 那样 直接 使 用 “0” 操 作 符 来 调用 这 个 类 的 invoke 操作 符 函数 。 用 代码 示例 
来 说 明 可 能 会 更 容易 理解 ， 下 面 是 一 个 简单 的 示例 代码 : 


>>> class Hello{ 
operator fun invoke (name:String){ 
println ("Hello, $name") 
} 
oe i 
>>> val hello = Hello() 
>>> hello("World") //Hello 对 象 的 invoke 方法 的 调用 约定 写法 
Hello, World 
>>> hello("Kotlin") 
Hello, Kotlin 
这 段 代 码 在 Hello 类 中 定义 了 一 个 操作 符 函数 invoke, 然后 我 们 声明 了 一 个 Hello 类 的 
实例 对 象 hello， 接 下 来 神奇 的 事情 发 生 了 : 


hello ("World") 


我 们 直接 把 这 个 实例 对 象 hello 作为 函数 来 调用 了 : 给 它 传 入 了 参数 World， 在 REPL 
中 运行 上 面 的 代码 ， 发 现 可 以 正确 输出 了 : 

>>> hello("World") 

Hello, World 

这 个 特性 一 般 情况 下 在 程序 代码 中 很 少 使 用 到 , 但 是 在 DSL 中 将 会 非常 有 用 。 这 个 特 
性 会 使 得 我 们 的 DSL 代码 更 加 简洁 而 清晰 。 


10.3 ”实现 集合 类 的 流 式 Kotlin DSL 


我 们 对 Java 的 工具 类 非常 熟悉 ， 如 java.util.Collections， 这 样 的 类 里 提供 了 很 多 静态 
方法 ， 例 如 : 

public static <T> boolean addAll(Collection<? super T> c, T... elements) 

public static <T> int binarySearch(List<? extends Comparable<? super T>> 

list, T key) 

public static void reverse (List<?> list) 

public static void shuffle(List<?> list) 

public static <T extends Comparable<? super T>> void sort (List<T> list) 


而 在 实际 编码 中 ， 通 常 这 样 调用 这 些 静 态 方法 : 


Collection.reverse (list); 
Collection.sort (list); 
int index = Collections.binarySearch(list, x); 


这 看 起 来 并 不 “简单 漂亮 ”。 我 们 期 望 直接 这 样 调用 这 些 方法 : 


ist sort()s 
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val index = list.binarySearch (x); 


这 就 是 Kotlin 中 的 扩展 函数 ， 我 们 只 要 把 接收 器 类 型 放 在 其 名 称 的 前 面 : 


fun <T : Comparable<T>> List<T>.sort() { 
Collections.sort (this) 
I 


这 里 的 this 参数 代表 调用 该 函数 的 对 象 〈 函 数 接收 者 ) 。 有 了 扩展 函数 ， 我 们 就 可 以 
开始 创建 “ 流 式 API” DSL 了 。 
下 面 来 创建 一 个 给 定 文件 名 返回 文件 中 每 行文 本 字符 串 的 流 式 API。 代 码 风格 是 下 面 
这 样 的 : 
fun main(args: Array<String>) { 
val lines = 
"src/main/resources/data.txt" 
.stream() 
.buffered() 


.reader ("utf-8") 
.readLines () 


lines.forEach(::println) 


} 
首先 给 String 类 型 扩展 一 个 stream() PA AL: 
fun String.stream() = FileInputStream(this) 


然后 给 FileInputStream 扩展 一 个 buffered0 函 数 : 


fun FileInputStream.buffered() = BufferedInputStream(this) 


接着 给 InputStream 扩展 一 个 reader(charset: String) 函 数 : 


fun InputStream. reader (charset: String) = InputStreamReader (this, charset) 


再 给 Reader 扩展 一 个 readLines() fir. 


fun Reader.readLines(): List<String> { 
val result = arrayListOf<String>() 
forEachLine { 
result.add(it) 
} 
return result 


} 


有 了 这 些 扩展 函数 ， 就 可 以 使 用 上 面 的 流 式 API 了 。 实 际 上 ，Kotlin 中 的 VO 文件 读 
写 及 集合 类 中 的 流 式 API 就 是 这 么 扩展 Java 中 的 API 的 。 


10.4 实现 一 个 SQL 风格 的 集合 类 DSL 


集合 类 的 过 滤 查 询 函 数 有 没有 可 能 具备 SQL 一 样 的 风格 呢 ? 类 似 下 面 这 个 简单 的 示例 : 


val queryResult = students.select () 
-where { 让 -Score >= 80 } 
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Herp, Student 是 一 个 简单 的 数据 类 : 


data class Student (var name: String, var sex: String, var score: Int) 


students 变量 的 初始 化 值 是 : 


val students = listOf( 
Student ("jack", "M", 90), 
Student ("alice", "F", 70), 
Student ("bob", "M", 60), 
Student ("bill", , 80), 
Student ("helen", "F", 100) 


) 
下 面 我 们 先 来 创建 List 的 扩展 函数 select0， 代 码 如 下 : 


fun <E> List<E>.select(): List<E> = this 


然后 实现 where0 高 阶 函 数 ， 代 码 如 下 : 


fun <E> List<E>.where (predicate: (E) -> Boolean): List<E> { 

val list = this 
val result = arrayListOf<E>() 
for (e in Tist) { 

if (predicate (e)) { 

result.add (e) 

} 
} 
return result 


} 


where() 函 数 的 实现 跟 filter0 函 数 基本 一 致 。 
接着 实现 andO 高 阶 函数 ， 代 码 如 下 : 
fun <E> List<E>.and(predicate: (E) -> Boolean): List<E> { 


return where (predicate) 


} 


and() rh ACM YEAR EER whereO 函 数 的 逻辑 一 致 ， 因 此 这 里 直接 调用 where(predicate) 
完整 的 代码 如 下 : 
package com.easy.kotlin.dsl 


fun main(args: Array<String>) { 


val students = listOf( 
Student ("jack", "M", 90), 
Student ("alice", "En, 70), 
Student ("bob", "M", 60), 
Student ("bill", "M", 80), 
Student ("helen", "F", 100) 
) 


val queryResult = students.select () 
-where { it.score >= 80 } 
sand { it.sex == "M" } 
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println (queryResult) 
1 


fun <E> List<E>.where (predicate: (E) -> Boolean): List<E> { 

val list = this 
val result = arrayListOf<E>() 
for (e in list) { 

if (predicate(e)) { 

result.add(e) 

} 

} 


return result 


} 


fun <E> List<E>.and(predicate: (E) -> Boolean): List<E> { 
return where (predicate) 
} 
fun <E> List<E>.select(): List<E> = this 
data class Student(var name: String, var sex: String, var score: Int) 


运行 上 面 的 代码 ， 输 出 如 下 : 


[Student (name=jack, sex=M, score=90), Student (name=bill, sex=M, score=80) 
10.5 本 章 小 结 


相 比 于 Java, Kotlin 对 函数 式 编程 的 支持 更 加 友好 。Kotlin 的 扩展 函数 和 高 阶 函 数 
(Lambda 表达 式 ) ， 为 定义 KotlinDSL 提供 了 核心 的 特性 支持 。 
使 用 DSL 的 代码 风格 ， 可 以 让 我 们 的 程序 更 加 直观 易 懂 、 简 洁 优雅 。 使 用 Kotlin 实现 
-个 DSL 非常 简单 ， 而 且 相当 使 用 。 
本 章 示 例 代 码 地 址 https://github.com/EasyKotlin/dsl。 
另外 ， 在 笔者 的 另 一 本 书 《Kotlin 极 简 教程 》 的 第 14 章 中 实现 了 一 个 类 似 jQuery 中 
AJAX 的 HTTP 请 求 的 DSL， 感 兴趣 的 读者 可 以 阅读 参考 。 
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SUS 运算 符 重 载 与 约定 


我 们 在 第 2 章 Kotlin 语法 基础 中 已 经 学 习 过 关于 运算 符 的 相关 内 容 ， 本 章 将 继续 深入 
探讨 Kotlin 中 运算 符 的 重 载 与 约定 。 

通常 一 门 编程 语言 中 都 会 内 团 预 定义 的 运算 符 〈 如 +、-、*、 人 一 、 吐 等) ， 这 些 运 
算 符 的 操作 对 象 只 能 是 基本 数据 类 型 。 而 在 实际 的 编程 场景 中 有 很 多 自 定义 类 型 ， 其 实 也 
有 类 似 的 运算 操作 。 这 就 是 我 们 通常 所 说 的 运算 符 重 载 (overload) 。 

Java 中 是 不 支持 运算 符 重 载 的 。 而 Kotlin 支持 操作 符 重 载 。 这 些 操作 符 在 Kotlin 中 是 
约定 好 的 固定 符号 (如 加 法 符号 +、 乘 法 符号 *) 和 固定 的 优先 级 。 而 实现 这 样 的 操作 符 ， 
我 们 也 必须 使 用 映射 的 固定 名 字 的 成 员 函 数 或 扩展 函数 (加 法 plus、 乘 法 times) 。 重 载 操 
作 符 的 函数 需要 用 operator 修饰 符 来 标记 。 


11.1 什么 是 运算 符 重 载 


运算 符 重 载 是 对 已 有 的 运算 符 赋予 新 的 含义 ， 使 同一 个 运算 符 作用 于 不 同类 型 的 数据 
会 有 对 应 这 个 数据 类 型 的 行为 。 

运算 符 重 载 的 实质 是 函数 重 载 ， 本 质 上 是 对 运算 符 函 数 的 调用 ， 从 运算 符 到 对 应 函数 
的 映射 过 程 由 编译 器 完成 。 由 于 一 般 数 据 类 型 间 的 运算 符 没有 重 载 的 必要 ， 所 以 运算 符 重 
载 主要 是 面向 对 象 之 间 的 。 

Kotlin 中 的 运算 符 重 载 约 定 定义 在 org.jetbrains.kotlin util.OperatorNameConventions 中 : 


package org.jetbrains.kotlin.util 
import org.jetbrains.kotlin.name.Name 


object OperatorNameConventions { 
@JvmField val GET VALUE = Name.identifier ("getValue") 
@JvmField val SET VALUE = Name.identifier ("setValue") 
@JvmField val PROVIDE DELEGATE = Name.identifier ("provideDelegate") 


@JvmField val EQUALS = Name.identifier ("equals") 
@JvmField val COMPARE TO = Name.identifier("compareTo") 
@JvmField val CONTAINS = Name. identifier ("contains") 
@JvmField val INVOKE = Name. identifier ("invoke") 
@JvmField val ITERATOR = Name.identifier ("iterator") 
@JvmField val GET = Name.identifier ("get") 

@JvmField val SET = Name.identifier ("set") 

@JvmField val NEXT = Name.identifier ("next") 

@JvmField val HAS NEXT = Name.identifier ("hasNext") 
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@JvmField val COMPONENT REGEX = Regex ("component\\d+") 


@JvmField val AND = Name.identifier ("and") 
@JvmField val OR = Name.identifier ("or") 


@JvmField val INC = Name.identifier ("inc") 
@JvmField val DEC = Name.identifier ("dec") 
@JvmField val PLUS = Name.identifier ("plus") 
@JvmField val MINUS = Name.identifier ("minus") 
@JvmField val NOT = Name.identifier ("not") 


@JvmField val UNARY MINUS = Name identifier ("unaryMinus") 
@JvmField val UNARY PLUS = Name.identifier("unaryPlus") 


@JvmField val TIMES = Name.identifier ("times") 
@JvmField val DIV = Name.identifier ("div") 
@JvmField val MOD Name. identifier ("mod") 
@JvmField val REM = Name.identifier ("rem") 
@JvmField val RANGE TO = Name.identifier("rangeTo") 


@JvmField val TIMES ASSIGN = Name.identifier ("timesAssign") 
@JvmField val DIV ASSIGN = Name.identifier ("divAssign") 
@JvmField val MOD ASSIGN = Name.identifier ("modAssign") 
@JvmField val REM ASSIGN Name.identifier ("remAssign") 
@JvmField val PLUS ASSIGN = Name.identifier ("plusAssign") 
@JvmField val MINUS ASSIGN = Name.identifier ("minusAssign") 


@JvmField 
internal val UNARY OPERATION NAMES = setOf(INC, DEC, UNARY PLUS, 
UNARY MINUS, NOT) 


@JvmField 
internal val SIMPLE UNARY OPERATION NAMES = setOf (UNARY PLUS, UNARY_ 
MINUS, NOT) 


@JvmField 
val BINARY OPERATION NAMES = setOf (TIMES, PLUS, MINUS, DIV, MOD, REM, 
RANGE_TO) 


@JvmField 
internal val ASSIGNMENT OPERATIONS = setOf(TIMES ASSIGN, DIV_ASSIGN, 
MOD ASSIGN, REM ASSIGN, PLUS_ASSIGN, MINUS_ASSIGN) 

} 


运算 符 与 操作 符 函 数 的 映射 关系 定义 在 org jetbrains.kotlin.types.expressions.Operator 
Conventions.java 中 : 


public static final ImmutableBiMap<KtSingleValueToken, Name> UNARY 
OPERATION NAMES = ImmutableBiMap.<KtSingleValueToken, Name>builder () 

.put (KtTokens.PLUSPLUS, INC) 

-put (KtTokens.MINUSMINUS, DEC) 

-put (KtTokens.PLUS, UNARY PLUS) 

-put (KtTokens.MINUS, UNARY MINUS) 

-put (KtTokens.EXCL, NOT) 

prada 和 区 


public static final ImmutableBiMap<KtSingleValueToken, Name> BINARY_ 
OPERATION NAMES = ImmutableBiMap.<KtSingleValueToken, Name>builder () 
-put (KtTokens.MUL, TIMES) 
-put (KtTokens.PLUS, PLUS) 
-put (KtTokens.MINUS, MINUS) 
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-put (KtTokens.DIV, DIV) 

-put (KtTokens.PERC, REM) 

-put (KtTokens.RANGE, RANGE TO) 
-build(); 


public static final ImmutableBiMap<Name, Name> REM TO MOD OPERATION 
NAMES = ImmutableBiMap.<Name, Name>builder() 

-Put (REM, MOD) 

-put (REM ASSIGN, MOD ASSIGN) 

-build(); 


public static final ImmutableBiMap<KtSingleValueToken, Name> ASSIGNMENT 
OPERATIONS = ImmutableBiMap.<KtSingleValueToken, Name>builder () 

-put (KtTokens .MULTEQ, TIMES ASSIGN) 

-Put (KtTokens.DIVEQ, DIV ASSIGN) 

-put (KtTokens.PERCEQ, REM ASSIGN) 

.put (KtTokens.PLUSEQ, PLUS ASSIGN) 

-put (KtTokens .MINUSEQ, MINUS ASSIGN) 

-build(); 


Rb, KtTokens.kt 中 定义 了 +、-、*、/ 人 、 一 、!、++、--、#=、 大 等 运算 符 的 符号 。 从 
源码 中 的 这 一 句 : 


public static final ImmutableSet<KtSingleValueToken> NOT OVERLOADABLE = 
ImmutableSet .of (KtTokens.ANDAND, KtTokens.OROR, KtTokens.ELVIS, 
KtTokens.EQEQEQ, KtTokens.EXCLEQEQEQ) ; 


可 以 知道 ，Kotlin nes, ||. 2. ==. I= RARER EAI. 
有 了 操作 符 重 载 ， 我 们 可 以 将 两 个 对 象 加 起 来 变 成 另外 一 个 对 象 。 例 如 ， 我 们 自 定义 
-个 BoxInt 类 型 ， 然 后 重 载 times (乘法 *) 函数 、plus (加 法 +) 函数 。 


class BoxInt (var i: Int) { 
operator fun times(x: BoxInt) = BoxInt(i * x.i) // 使 用 类 成 员 函 数 重 载 


override fun toString(): String { 
return i.toString() 
} 
} 


operator fun BoxInt.plus(x: BoxInt) = BoxInt (this.i + x.i) // 使 用 扩展 函数 的 方式 重 载 
然后 ， 我 们 的 测试 代码 如 下 : 


fun main(arg: Array<String>) { 
val a = BoxInt (3) 
val b = BoxInt (7) 
printin(a + b) //10 
println(a * b) //21 

} 


运算 符 重 载 其 实 是 Kotlin 的 一 个 语法 糖 。 我 们 可 以 把 上 述 代码 反 编译 成 Java 字 节 码 ， 
可 以 看 到 atb 其 实 是 等 价 于 Java 中 的 


public static final BoxInt plus (@NotNull BoxInt $receiver,@NotNull BoxInt x) { 


return new BoxInt ($receiver.getI() + x.getI()); 


i 


下 面 是 ath 被 编译 成 class 代码 之 后 的 样子 。 第 3 行 的 INVOKESTATIC 验证 了 上 面 的 
说 明 : 
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ALOAD 1 

ALOAD 2 

INVOKESTATIC com/easy/kotlin/OperatorOverloadDemoKt.plus (Lcom/easy/ kotlin/ 
BoxInt; Lcom/easy/kotlin/BoxInt; ) Lcom/easy/kotlin/BoxInt; 

POP 


而 a*b 等 价 于 Java 中 的 : 


public final class BoxInt { 
public final BoxInt times (@NotNull BoxInt x) { 


TEKENT. new BoxInt (this.i * x.i); 
} 

a oe 
对 应 的 字 节 码 如 下 。 同 样 地 ， 第 3 行 INVOKEVIRTUAL 表明 运算 符 重 载 确实 是 Kotlin 在 
编译 器 层面 实现 的 一 个 语法 糖 。 

ALOAD 1 

ALOAD 2 

INVOKEVIRTUAL com/easy/kotlin/BoxInt.times (Lcom/easy/kotlin/BoxInt;) Lcom/ 

easy/kotlin/BoxInt; 

POP 

从 上 面 的 例子 分 析 中 可 以 看 出 ，Kotlin 在 编译 器 层面 做 了 大 量 工作 ， 就 是 为 了 让 
更 简洁 ， 让 编译 器 处 理 更 多 的 事情 。 毋 庸 置疑 的 是 Kotkin 的 简洁 优雅 而 且 强大 实用 的 语法 
和 各 种 各 样 的 语法 糖 可 以 大 大 地 提升 程序 员 的 工作 效率 。 这 些 都 是 直接 使 用 Java SABI 
的 特性 。 


112 重 载 二 元 算术 运算 符 
通过 阅读 上 面 的 源码 ， 可 以 总 结 出 Kotlin 中 的 二 元 运算 符 与 重 载 函数 名 称 之 间 的 映射 


关系 ， 如 表 11-1 所 示 。 
表 11-1 二 元 运算 符 与 重 载 函 数 名 称 之 间 的 映射 关系 


二 元 运算 符 重 载 函数 名 称 & it 
a+b a.plus(b) 加 法 操作 
a-b a.minus(b) 减法 操作 
a*b a.times(b) 乘法 操作 
a/b a.div(b) 除法 操作 
a%b a.rem(b) 取 余 操 作 ， 早 期 版 本 中 叫 mod 
a..b a.rangeTo(b) 范围 操作 符 


例如 ， 一 个 简单 的 1+1=2 的 运算 的 实例 代码 如 下 : 


x 
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>>> 1.plus (1) 


2 
Kotlin 中 使 用 operator fun 声明 重 载运 算 符 函数 。 例 如 上 面 的 Int 类 型 的 加 法 运算 符 函 
数 的 声明 如 下 : 


operator fun plus(other: Byte): Int 


自 定义 类 型 运算 符 重 载 函 数 的 作用 ， 与 内 置 赋值 运算 符 的 作用 是 同样 的 声明 方式 ， 但 
是 具体 的 运算 逻辑 的 实现 则 是 “ 自 定义 ”的 。 

编程 实例 题 : 设计 一 个 类 Complex, 实现 复数 的 基本 操作 。 例如， 相 加 : (142i)+(3+4i)= 
4+6i; 相 减 ，(1+2i)-(3+4i)=-2-2i， 相 乘 : (1+2i)*(3+4i)=-5+10i。 

我 们 设计 Complex 类 如 下 。 

口 AREE: 实 部 real， 虚 部 image， 均 为 整数 变量 ; 

O 构造 方法 : 无 参 构造 函数 、 有 参 构造 函数 (参数 2 个) ; 

O 成 员 方法 : 两 个 复数 的 加 、 减 、 乘 操作 。 

(1) 首先 声明 一 个 类 Complex, 在 里 面 声明 两 个 Int 成 员 变 量 real 和 image. 代码 如 下 : 

package com.easy.kotlin 


class Complex { 
var real: Int = 0 
var image: Int = 0 
i 
使 用 IDEA 进行 Kotlin 编程 的 过 程 是 非常 享受 的 。 直 接 在 当前 源码 文件 Complex 类 内 
右 击 ， 自 动 生成 无 参 构造 函数 、2 个 参数 的 构造 函数 ， 代 码 如 下 : 
package com.easy.kotlin 
class Complex { 


var real: Int = 0 
var image: Int = 0 


constructor () 
constructor(real: Int, image: Int) { 
this.real = real 
this.image = image 
} 
} 
我 们 看 到 ，Generate x} iF HEH Iw] DL Dat equals, hashCode XAI toString() rg 
数 ， 可 以 选择 Override Methods, Implement Methods 和 自动 生成 Copyright 等 功能 。 
(2) 实现 加 法 、 减 法 、 乘 法 运算 符 重 载 函 数 。 
复数 加 法 的 运算 规则 是 : 实 部 加 上 实 部 ， 虚 部 加 上 虚 部 。(a+bi)+(c+di)=(a+c)+(b+d)i 
对 应 的 算法 实现 函数 是 : 


operator fun plus(c: Complex): Complex { 
return Complex(this.real + c.real, this.image + c.image) 
} 
复数 减法 的 运算 规则 是 ， 实 部 减 去 实 部 ， 虚 部 减 去 虚 部 。(atbi)-(ctdi)=(a-c)+(b-d)i 
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对 应 的 算法 实现 函数 是 : 


operator fun minus(c: Complex): Complex { 
return Complex (this.real - c.real, this.image - c.image) 


} 
复数 乘法 的 运算 规则 是 按照 乘法 分 配 律 展 开 。(a+bi)(ct+di)=ac-db+(bctad)i 对 应 的 算法 
实现 函数 是 : 
operator fun times(c: Complex): Complex { 
return Complex (this.real * c.real - this.image * c.image, this.real * 


c.image + this.image * c.real) 


} 
为 了 可 读 性 更 好 ， 我 们 重 写 toString0 函 数 如 下 : 


override fun toString(): String { 
val img = if (image >= 0) "+ ${image}i" else "${image}i" 
return "Sreal ${img} " 


} 
测试 代码 如 下 : 
fun main(args: Array<String>) { 


val cl = Complex(1, 1) 
val c2 = Complex(2, 2) 


val p= cI + c2 
val m= c1 - c2 
val t = cl * c2 
println(p) 
Println (m) 
printin(t) 

} 

输出 如 下 : 

EENG 

Geet 

HESE 


11.3 重 载 自 增 自 减 一 元 运算 符 


已 经 知道 Kotlin 中 可 以 重 载 的 一 元 运算 符 如 表 11-2 所 示 。 


表 11-2 一 元 运算 符 


运算 符 函 数 


a.unaryPlus() 


a.unaryMinus() 
a.not() 
a.inc() 
a.dec() 


现在 就 用 实例 来 说 明 怎 样 
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unaryMinus 运算 符 函 数 的 重 载 。 


class Point (val x: Int, val y: Int) { 
operator fun unaryMinus() = Point (-x, -y) 
override fun toString(): String { 
return "Point (x=$x, y=$y)" 
} 
j; 


测试 代码 如 下 


val pl = Point(1, 1) 
println(-p1) //Point(x=-1, y=-1) 


现在 给 Java 中 的 BigDecimal 类 型 添加 一 个 自 增 运算 符 inc0 函 数 ， 给 已 有 的 类 添加 运 


算 符 重 载 函 数 ， 我 们 采用 扩展 函数 来 实现 。 定 义 operator fun BigDecimal.inc()， 实 现代 码 


如 


而 


F: 
operator fun BigDecimal.inc() = this + BigDecimal.ONE 
然后 就 可 以 直接 对 一 个 BigDecimal 类 型 进行 自 增 的 操作 了 。 测 试 代码 如 下 : 


var bigDecimall = BigDecimal (100) 
var bigDecimal2 = BigDecimal (100) 


val tmpl 
val tmp2 


bigDecimal1++ 
++bigDecimal2 


println (tmp1) //100 
println (tmp2) //101 


printin(bigDecimal1) //101 
println (bigDecimal2) //101 


因为 自 增 后 级 表达 式 是 先 返 回 表达 式 的 值 , 然后 进行 加 1 操作 , 所 以 tmp] 的 值 是 100; 
自 增 前 级 表达 式 是 加 1 后 值 作为 表达 式 的 值 ， 所 以 tmp2 的 值 是 101。 而 在 下 一 行 打印 变 


量 bigDecimall 、bigDecimal2 的 值 都 是 101. 


大 | 


类 似 的 自 减 运算 符 重 载 函 数 实现 如 下 : 
operator fun BigDecimal.dec() = this - BigDecimal.ONE 
测试 代码 如 下 : 


var bigDecimal3 BigDecimal (100) 
var bigDecimal4 BigDecimal (100) 
val tmp3 = bigDecimal3— 


val tmp4 = --bigDecimal4 
Println (tmp3) //100 
Println (tmp4) //99 


println (bigDecimal3) //99 
println (bigDecimal4) //99 


而 之 所 以 能 在 实现 函数 中 直接 调用 thistBigDecimal.ONE 和 this-BigDecimal.ONE， 是 
为 Kotlin 语言 本 身 己 经 对 BigDecimal 进行 了 加 法 、 减 法 、 乘 法 、 取 余 、 取 负 等 运算 符 的 


重 载 。 这 些 重 载运 算 符 函数 定义 在 BigNumberskt 中 。 
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public inline operator fun BigDecimal .plus (other: BigDecimal) : BigDecimal 
= this.add(other) 


public inline operator fun BigDecimal.minus (other: BigDecimal) : BigDecimal 
= this.subtract (other) 


public inline operator fun BigDecimal.times (other: BigDecimal) : BigDecimal 
= this.multiply (other) 


public inline operator fun BigDecimal.div(other: BigDecimal) : BigDecimal 
= this.divide (other, RoundingMode.HALF_ EVEN) 


public inline operator fun BigDecimal.mod(other: BigDecimal) : BigDecimal 
= this.remainder (other) 


public inline operator fun BigDecimal.rem(other: BigDecimal) : BigDecimal 
= this.remainder (other) 


public inline operator fun BigDecimal.unaryMinus() : BigDecimal = 
this .negate () 


这 些 运 算 符 重 载 函 数 实现 的 背 


于 后 其 实 就 是 调用 的 BigDecimal 的 add0、subtractO、 


multiply()、divide()、remainder()、negate() 等 方法 。 

可 以 看 出 , Kotlin 通过 更 高 层次 的 封装 ， 大 大 简化 了 BigDecimal 数据 类 型 的 算术 运算 
的 代码 ， 使 得 BigDecimal 算术 运算 的 代码 更 加 简单 、 易 读 。 而 在 Java 中 ， 都 不 得 不 使 用 
元 长 的 方 法 名 进行 调用 。 
员 来 说 ， 无 疑 是 更 加 简洁 明了 了 。 


我 们 知道 ， 在 Java 中 ， 


的 比较 。 例 如 : 


public static 


int x = 
int y = 


boolean 
boolean 
boolean 
boolean 
boolean 
boolean 


System.out. 
System.out. 
System.out. 


1; 
ile 


bl = 
b2 = 


b3 
b4 
b5 
b6 


虽然 Kotlin 背后 调用 的 仍然 是 Java 的 方法 , 但 是 对 于 Kotlin 程序 
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tS. SS 


、<=、 一 、 上 ”运算 符 只 能 作用 于 基本 数据 类 型 


void main(String[] args) { 


> y; 
LS E 
Ze AV 
SS WE 
== 
Le y; 


println(b1); 
println(b2); 
println (b3); 
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System.out.println (b4); 

System.out.print1n(b5) ; 

System.out.print1n(b6) ; 
} 


而 在 对 象 类 型 上 是 不 允许 使 用 这 些 比较 运算 符 进行 比较 的 ， 如 图 11-1 所 示 。 
= BigDecimal bd1 = BigDecimal. ONE; 
33 BigDecimal bd2 = BigDecimal. ONE; 
34 boolean b7 = bdl > bd2; 


Operator '>' cannot be applied to ‘java.math.BigDecimal', ‘java.math.BigDecimal’ 


38 
i¢ 39 
40 


图 11-1 对 象 类 型 上 不 允许 使 用 比较 运算 符 


而 实际 上 ， 只 要 给 定 一 个 比较 标准 ， 原 则 上 对 象 之 间 也 是 可 以 比较 大 小 的 ， 而 不 是 仅 
仅 限 于 基本 数据 类 型 。 因 为 在 Kotlin 中 一 切 类 型 都 是 引用 类 型 。 所 以 ， 对 象 之 间 的 比较 将 
是 “自然 而 然 ” 的 。 本 节 主 要 介绍 比较 运算 符 的 重 载 。 

上 面 的 BigDecimal 比较 的 Java 代码 ， 在 Kotlin 中 是 允许 的 : 


val bdl = BigDecimal.ONE 
val bd2 = BigDecimal.ONE 
val bdbd = bdl > bd2 
val bdeq = bdl == bd2 


val bdegeq = bdl === bd2 
println (bdbd) //false 
println (bdeq) //true 
println (bdeqeq) //true 


其 中 的 大 于 号 “>” 会 映射 成 调用 compareTo(BigDecimal val)>0 的 值 。 Kotlin 中 的 比较 
运算 符 与 重 载 函 数 名 之 间 的 映射 关系 如 表 11-3 所 示 。 


表 11-3 ”比较 运算 符 


R 达 式 翻译 成 函数 调用 
a>b a.compareTo(b) > 0 
a<b a.compareTo(b) < 0 
a>=b a.compareTo(b) >= 0 
a<=b a.compareTo(b) <= 0 


两 个 等 于 号 “==” 会 映射 成 调用 equals(Object x) 方 法 。 需 要 注意 的 是 ，a 一 b 表达 式 
中 就 算 a、b 是 null， 也 可 以 安全 调用 。 因 为 a=b 会 被 Kotlin 编译 器 翻译 成 带 可 空 性 判断 
的 equals0 方 法 的 调用 ， 即 a?.equals(b)?:(b ===null). 

而 3 个 等 于 号 “===” 是 Kotlin 中 自己 实现 的 运算 符 ， 这 个 运算 符 不 能 被 重 载 ， 它 不 
仅 会 比较 值 是 否 相 等 ， 还 会 去 比较 对 象 的 引用 是 否 相等 。 因 为 BigDecimal.ONE 是 常量 ， 
在 JVM 内 存 模型 中 是 存在 常量 区 的 ， 所 以 bdl 一 = bd2 返回 的 也 是 true. 

例如 ， 下 面 的 Point 38: 

class Point(val x:Int, val y:Int) 


如 果 我 们 不 去 重 载 实现 其 equals0 函 数 ， 编 译 器 会 自动 生成 一 个 equals0 函 数 与 hashCodeO 
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准 是 


class Point (val x:Int, val y:Int) { 
override fun equals(other: Any?): Boolean { 
if (this === other) return true 
if (javaClass != other?.javaClass) return false 


other as Point 
if (x != other.x) return false 
if (y != other.y) return false 


return true 


} 


override fun hashCode(): Int { 
var result = x 
result = 31 * result + y 
return result 


} 

而 如 果 我 们 想 自 定 义 相等 的 判断 方法 ， 可 以 进行 重 写实 现 其 equalsO 函 数 。 

现在 , 我 们 来 比较 两 个 Point 对 象 的 大 小 。 如 果 我 们 定义 Point 对 象 之 间 大 小 的 比较 标 
:其 范 数 〈 用 来 度量 某 个 向 量 空间 或 矩阵 ) 中 的 每 个 向 量 的 长 度 ) 大 小 ， 那 么 比较 运 


算 符 的 重 载 函数 实现 如 下 


operator fun compareTo(other: Point): Int { 
val thisNorm = Math.sqrt ((this.x * this.x + this.y * this.y) .toDouble()) 


val otherNorm = Math.sqrt((other.x * other.x + other.y * other. 


vi. toDouble () ) 
return thisNorm.compareTo (otherNorm) 


ji 
测试 代码 如 下 


val pl = Point(1, 1) 
val p2 = Point(1, 1) 
val p3 = Point(1, 3) 


println(pl >= p2) //true 
println (p3 > p1) //true 


11.5 重 载 计 算 赋 值 运 算 符 


计算 赋值 运算 符 如 表 11-4 所 示 。 
表 11-4 计算 赋值 运算 符 


ZS 达 式 翻译 成 运算 符 重 载 函数 的 调用 
at=b a.plusAssign(b) 
a 一 a.minusAssign(b) 
a*=b a.timesAssign(b) 
a/=b a.divAssign(b) 
a%=b a.remAssign(b) 
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EE 载 函 数 


Iech 


如 果 我 们 想 要 重 载 某 个 类 型 的 这 些 赋值 运算 符 ， 只 需要 实现 其 对 应 的 运算 符 
即 可 。 


11.6 本 章 小 结 


在 进行 对 象 之 间 的 运算 时 ， 编 译 器 解析 的 时 候 会 去 调用 对 应 运算 符 重 载 函 数 。 为 了 使 
代码 简单 易 懂 ， 在 实现 运算 符 重 载 函 数 的 时 候 一 定 要 考虑 其 实际 问题 场景 的 意义 ， 并 且 在 
运算 符 重 载 函数 上 写 清楚 对 象 之 间 的 比较 规则 ， 注 释 写 清楚 。 如 果 滥 用 运算 符 重 载 ， 会 导 
致 代 码 易 读 性 大 大 下 降 。 


第 12 章 元 编程 、 注 解 与 反射 


反射 Reflection) 是 在 运行 时 获取 类 的 函数 〈 方 法 ) 、 属 性 、 父 类 、 接 口 、 注 解 元 数 
据 、 泛 型 信息 等 类 的 内 部 信息 的 机 制 。 这 些 信息 称 之 为 RTTI (Run-Time Type Information, 
运行 时 类 型 信息 )。 

注解 〈Annotation) 是 我 们 给 代码 添加 的 元 数据 。 使 用 注解 可 以 写 出 更 加 简洁 、 干 净 
的 代码 ， 同 时 还 可 以 在 编译 期 进行 类 型 检查 。Kotlin 的 注解 完全 兼容 Java 的 注解 。 

本 章 主要 介绍 Kotlin 中 注解 与 反射 编程 的 相关 内 容 。 


12.1 元 编程 简介 


说 到 元 编程 (Meta-programming) ， 要 先 从 Meta- 这 个 前 缀 开始 说 起 。Meta- 前 绥 在 西 
方 哲学 界 是 指 : 关于 事物 自身 的 事物 。 例 如 ， 心 理学 领域 有 一 门 专门 研究 关于 人 类 认 知 心 
理 的 学 科 叫 认 知 心理 学 〈cognitive psychology) ， 还 有 一 门 学 科 是 研究 人 类 对 自己 的 认 知 
过 程 的 认 知 ,叫做 元 认 知 心理 学 (Meta-cognitive psychology ) ， 又 称 反省 认 知 、 监 控 认 知 、 
超 认 知 、 反 审 认 知 等 。 元 认 知 的 本 质 是 人 类 对 自身 认 知 活动 的 自我 意识 和 自我 调节 。 

再 例如 ，Meta-knowledge 就 是 “关于 知识 本 身 的 知识 ”，Meta-data 就 是 “关于 数据 
的 数据 ”，Meta-language 就 是 “关于 语言 的 语言 ”， 而 Meta-programming 就 是 “关于 编 
程 的 编程 ”， 也 就 是 我 们 通常 所 说 的 “元 编程 ”。 

元 编程 (Meta-programming) 是 指 用 代码 在 编译 期 或 运行 期 生成 或 改变 代码 的 一 种 编 
程 形式 。 编 写 元 程序 的 语言 称 之 为 元 语言 ， 被 操纵 的 语言 称 之 为 目标 语言 。 如 果 一 门 语言 
中 具备 同时 是 元 语言 也 是 目标 语言 的 能 力 ， 这 就 是 反射 。 

一 般 代码 的 操作 对 象 是 数据 ， 元 编程 操作 的 对 象 是 其 他 代码 ， 无 关 业 务 逻 辑 ， 只 跟 当 
前 代码 结构 相关 的 代码 。 例 如 ， 在 Java 中 运行 时 通过 反射 把 所 有 以 *ServiceImpl 结尾 的 类 
找 出 来 ， 加 上 log 日 志 或 者 进行 监控 统计 等 其 他 动作 。 除 非 程序 运行 期 的 输入 数据 会 被 直 
接 或 间接 转化 成 代码 ， 否 则 元 编程 不 会 给 程序 带 来 新 的 逻辑 。 

元 编程 本 质 上 是 一 种 对 源 代码 本 身 进行 高 层次 抽象 的 编码 技术 。 元 编程 比 我 们 手写 的 
代码 多 提供 了 一 个 抽象 层次 ! 我 们 其 实 就 是 用 代码 中 的 元 数据 (按照 一 定 的 协议 规则 来 定 
义 ， 也 就 是 注解 的 语法 规范 ) 来 动态 插入 新 代码 逻辑 ， 就 是 用 来 动态 生成 代码 的 程序 。 其 
实 ， 根 本 没有 什么 “元 编程 ”， 有 的 只 是 “编程 ”。 

反射 是 促进 元 编程 的 一 种 很 有 价值 的 语言 特性 。 编 程 语言 中 的 泛 型 支持 也 使 用 元 编程 
能 力 。 元 编程 通常 有 两 种 方式 : 一 种 是 通过 应 用 程序 接口 (API) 来 暴露 运行 时 系统 的 内 
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部 信息 ; 另 一 种 方法 是 在 运行 时 动态 执行 包含 编程 命令 的 字符 串 。 因 此 ，“ 程 序 能 编写 程 
序 ”。 虽 然 两 种 方法 都 能 用 ， 但 大 多 数 时 候 主 要 用 其 中 一 种 。 

注解 是 把 编程 中 的 元 数据 信息 直接 写 在 源 代 码 中 ， 而 不 是 保存 在 外 部 文件 中 。 

在 使 用 注解 之 前 (甚至 在 使 用 之 后 ) ，XML 配置 文件 被 广泛 应 用 于 编程 过 程 中 对 元 数 
据 的 描述 。 后 来 程序 员 们 逐渐 发 现 XML 的 维护 越 来 越 糟糕 了 ， 进 而 希望 直接 使 用 一 些 和 
代码 紧 耦 合 的 “元 数据 ”， 而 不 是 像 XML 那样 和 代码 分 离 。 在 把 注解 使 用 得 淋漓 尽 致 的 
Spring Boot 框架 中 , 基本 不 需要 一 行 XML 配置 , 几乎 全 部 使 用 注解 就 可 以 完成 一 个 Spring 
企业 级 应 用 的 开发 。 

XMLvs.Annotation， 这 其 实 是 一 个 “阴阳 交融 ”的 编程 之 道 ， 很 多 时 候 要 看 具体 的 问 
题 场 景 来 决定 采用 哪 种 方式 。XML 配置 就 是 为 了 分 离 代码 和 配置 而 引入 的 , 而 注解 是 为 了 
希望 使 用 一 些 和 代码 紧 耦 合 的 东西 。 事 物 的 发 展 就 是 这 样 阴阳 交合 、 辩 证 发 展 的 过 程 。 

注解 是 将 元 数据 附加 到 代码 的 方法 。 而 反射 可 以 在 运行 时 把 代码 中 的 注解 元 数据 获取 
到 ， 并 在 目标 代码 执行 之 前 进行 动态 代理 ， 实 现 业务 逻辑 的 动态 注入 ， 这 其 实 就 是 AOP 
(Aspect Oriented Programming， 面 向 切面 编程 《也 叫 面向 方面 ) ) 的 核心 思想 一 一 通过 运 
行 期 动态 代理 〈 和 预 编 译 方式 ) 实现 在 不 修改 源 代 码 的 情况 下 ， 给 程序 动态 添加 新 功能 的 

-种 技术 。 

例如 ， 在 Spring、Mybatis、JPA 等 诸多 框架 中 的 核心 功能 都 是 使 用 了 注解 与 反射 的 技术 
来 实现 的 。 例 如 常用 的 Spring 框架 中 的 各 种 注解 @Repository, @Service, @Transactional, 
@RequestMapping、@ResponseBody 等 , 以 及 Mybatis 框架 中 的 各 种 注解 @Select\@Update、 
@Param 等 。 

另外 ， 需 要 重点 提 到 的 就 是 当下 非常 流行 的 Spring Boot 框架 。 在 使 用 Spring Boot HE 
架 开发 企业 级 应 用 时 ， 完 全 不 需要 使 用 一 行 XML 配置 ， 整 个 源 代码 工程 都 能 基于 注解 来 
开发 (application.propertis 配置 文件 另 当 别 论 ) ， 更 多 关于 SpringBoot 框架 开发 的 知识 ， 
将 在 后 面 的 章节 中 介绍 。 


122 注 解 


Kotlin 的 注解 跟 Java 注解 也 完全 兼容 。 我 们 可 以 在 Kotlin 代码 中 很 自然 地 使 用 Java 
中 的 注解 。 也 就 是 说 , 我 们 使 用 Kotlin 语言 集成 SpringBoot 框架 开发 的 过 程 将 会 非常 自然 ， 
几乎 与 使 用 原生 Java 语言 开发 一 样 流畅 , 同时 还 能 享受 Kotlin 语言 带 来 的 诸多 简洁 且 非 常 
强大 的 特性 。 


12.2.1 声明 注解 


Kotlin 中 声明 注解 使 用 annotation class 关键 字 。 例 如 ， 我 们 声明 两 个 注解 Run 和 
TestCase 如 下 : 


@Target (AnnotationTarget.CLASS, 
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AnnotationTarget .FUNCTION, 
AnnotationTarget .VALUE PARAMETER, 
AnnotationTarget .EXPRESSION) 
@Retention (AnnotationRetention. RUNTIME) 
@Repeatable 
@MustBeDocumented 
annotation class TestCase(val id: String) 


@Target (AnnotationTarget.CLASS, 
AnnotationTarget . FUNCTION, 
AnnotationTarget .VALUE_PARAMETER, 
AnnotationTarget .EXPRESSION) 

@Retention (AnnotationRetention. RUNTIME) 

@Repeatable 

@MustBeDocumented 

annotation class Run 


从 这 个 关键 字 上 可 以 看 出 注解 也 是 一 种 class, 编译 器 同样 可 以 对 注解 类 型 在 编译 期 进 

自 定义 的 注解 中 使 用 的 注解 〈 例 如 @Target、@Retention 等 ) ， 称 之 为 元 注解 
(Meta-annotation ) 。 通过 向 注解 类 添加 元 注解 的 方法 来 指定 其 他 属性 ,元 注解 说 明 如 表 12-1 
所 示 。 


表 12-1 元 注解 说 明 
元 注解 名 称 功能 说 明 
指定 这 个 注解 可 被 用 于 哪些 元 素 (这 些 元 素 定义 在 kotlin. annotation. 
AnnotationTarget 枚 举 类 中 。 它 们 是 : 类 CLASS 、 注 解 类 
ANNOTATION CLASS、 泛 型 参数 TYPE PARAMETER、 函数 FUNCTION, 
@Target 属性 PROPERTY ， 用 于 描述 域 成 员 变量 的 FIELD 、 局 部 变量 LOCAL 
VARIABLE, VALUE_PARAMETER, CONSTRUCTOR, PROPERTY GETTER, 
PROPERTY_SETTER， 以 及 用 于 描述 类 、 接 口 (包括 注解 类 型 ) BR enum 声明 
的 TYPE、 表 达 式 EXPRESSION、 文 件 FILE、 类 型 别名 TYPEALIAS 等 
指定 这 个 注解 的 信息 是 否 被 保存 到 编译 后 的 class 文件 中 , 以 及 在 运行 时 是 否 
可 以 通过 反射 访问 到 它 。 可 取 的 枚 举 值 有 3 个 ， 分 别 是 : SOURCE (注解 数据 
不 存储 在 二 进 制 输出 ) 、BINARY (注解 数据 存储 在 二 进 制 输出 中 ， 但 反射 不 
可 见 ) 、RUNTIME (注解 数据 存储 在 二 进 制 输出 中 , 可 用 于 反射 〈 默 认 值 ) 
@Repeatable 允许 在 单个 元 素 上 多 次 使 用 同一 个 注解 
表示 这 个 注解 是 公开 API 的 一 部 分 , 在 自动 产生 的 API 文档 的 类 或 者 函数 签名 
中 ， 应 该 包含 这 个 注解 的 信息 


@Retention 


@MustBeDocumented 


12.2.2 ”使 用 注解 


上 面 我 们 声明 了 Run 注解 , 它 可 以 使 用 在 CLASS、FUNCTION、VALUE PARAMETER 
和 EXPRESSION 上 。 我 们 这 里 给 出 的 示例 是 用 在 类 上 : 

@Run 

class SwordTest {} 

我 们 声明 的 TestCase 注解 有 个 构造 函数 , 传 入 的 参数 是 一 个 String 类 型 的 ID。 把 这 个 
注解 用 在 函数 上 : 
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@Run 
class SwordTest { 

@TestCase(id = "1") 

fun testCase(testId: String) { 

println("Run SwordTest ID = ${testId}") 

} 
} 
上 面 是 注解 在 代码 中 的 简单 使 用 示例 。 其 中 的 @TestCase(id="1") 是 注解 构造 函数 的 使 
注解 可 以 有 带 参数 的 构造 器 。 注 解 参数 可 支持 的 数据 类 型 如 下 : 
O 基本 数据 类 型 (Int,Float,Boolean,Byte,Double,Char,Long,Short); 
O String 类 型 ; 
口 KClass 类 型 ; 
口 enum 类 型 ; 
口 Annotation 类 型 。 
以 上 为 所 有 引用 类 型 的 数组 (注意 ， 不 包括 基本 数据 类 型 》。 
例如 下 面 都 是 合法 的 注解 构造 函数 的 参数 类 型 : 


annotation class TestCase(val id: String) 

annotation class TestCasee(val id: Int) 

annotation class TestCaseee(val id: Array<String>) 
annotation class TestCaseeee(val id: Run) 

annotation class TestCaseeeeee (val id: KClass<String>) 


而 下 面 的 两 种 声明 编译 不 通过 : 
annotation class TestCaseeeee (val id: Array<Int>) 
annotation class TestCaseeeeee(val id: SwordTest) 


另外 需要 注意 的 是 ， 注 解 类 型 中 不 能 有 null 类 型 ， 因 为 JVM 不 支持 将 null 作为 注解 


属性 的 值 进行 存储 。 如 果 注 解 用 作 另 一 个 注解 的 参数 时 ， 则 其 名 称 不 能 以 @ 字 符 为 前 绷 。 
例如 : 


annotation class AnnoX(val value: String) 
annotation class AnnoY ( 


val message: String, 
val annoX: AnnoX = AnnoX("X")) 


Java 注解 与 Kotlin 完全 兼容 。 下 面 是 一 个 Kotlin 使 用 JUnit4 进行 单元 测试 代码 编写 的 


例子 。 


package com.easy.kotlin 


import com.easy.kotlin.annotation.SwordTest 
import org.junit.Test 

import org.junit.runner.RunWith 

import org.junit.runners.JUnit4 


@RunWith (JUnit4::class) 
class AnnotationClassNoteTest { 
@Test 
fun testAnno() { 
val sword = SwordTest () 
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sword.testCase ("10000") 
} 
} 
可 以 看 出 , 除了 @RunWith(JUnit4::class) 的 反射 写法 稍微 有 点 不 同 外 , 剩 下 的 与 我 们 在 
Java 中 使 用 JUnit 的 注解 方式 基本 上 是 一 样 的 。 


12.2.3 ”处 理 注解 


定义 了 注解 ， 并 在 需要 的 时 候 给 相关 类 和 类 属性 加 上 注解 信息 后 ， 如 果 没 有 相应 的 注 
解 信息 处 理 逻 辑 流 程 ， 那 么 注解 可 以 说 是 废 了 ， 没 有 什么 实用 价值 。 如 何 让 注解 在 程序 运 
行 的 时 候 发 挥 其 特有 的 作用 呢 ? 核心 就 在 于 注解 处 理 的 代码 了 。 本 节 我 们 将 学 习 怎样 进行 
注解 信息 的 获取 和 处 理 。 因 为 注解 信息 的 获取 主要 是 使 用 反射 API， 所 以 也 会 在 本 节 中 讲 
到 反射 相关 的 内 容 。 

首先 ， 我 们 的 目标 测试 类 是 : 


@Run 
class SwordTest { 


@TestCase(id = "1") 

fun testCase(testId: String) { 
println("Run SwordTest ID = ${testId}") 

} 


} 
这 里 我 们 主要 介绍 @TestCase 注解 作用 在 函数 上 的 处 理 过 程 。 
1. ::class 引 用 


首先 声明 一 个 变量 指向 SwordTest 对 象 实例 : 

val sword = SwordTest () 

然后 就 可 以 通过 这 个 变量 来 获取 该 对 象 的 类 的 信息 。 使 用 ::class 来 获取 sword 对 象 实 
例 的 KClass 类 的 引用 。 

val kClass = sword::class 

上 面 的 这 行 代 码 ，Kotlin 编译 器 会 自动 推断 出 kClass 变量 的 类 型 是 

val kClass:KClass<out SwordTest> = sword::class 
这 个 KClass 数据 类 型 将 在 后 面 的 小 节 中 介绍 。 

2. declaredFunctions 扩展 属性 

下 面 我 们 需要 获取 sword 对 象 类 型 所 声明 的 所 有 函数 。Kotlin 中 可 以 直接 使 用 扩展 属 
性 declaredFunctions 来 获取 这 个 类 中 声明 的 所 有 函数 (对 应 的 反射 数据 类 型 是 KFunction)。 
代码 如 下 : 


val declaredFunctions = kClass.declaredFunctions 
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返回 的 是 一 个 Collection>， 其 中 ，<*> 是 Kotlin 泛 型 中 的 星 投影 ， 类 似 Java 中 的 <?> 通 
配 符 。 
declaredFunctions 扩展 属性 的 实现 源码 如 下 : 


@SinceKotlin ("1.1") 

val KClass<*>.declaredFunctions: Collection<KFunction<*>> 
get() = (this as KClassImp1) .data() .declaredMembers.filterIsInstance 
<KFunction<*>>() 


3. annotations 属 性 


KFunction 类 型 继承 了 KCallable, KCallable 又 继承 了 KAnnotatedElement。 KAnnotated 
Element 中 有 个 public val annotations:List 属性 里 存储 了 该 函数 所 有 的 注解 信息 。 通 过 遍历 
这 个 存储 Annotation 的 List， 可 以 获取 到 TestCase 注解 : 

for (f in declaredFunctions) { 


// 处 理 TestCase 注解 ， 使 用 其 中 的 元 数据 
f.annotations.forEach { 
if (it is TestCase) { 
val id = it.id //TestCase 注解 的 属性 ID 
doSomething(id) ”// 注 解 处 理 逻 辑 


4. call 函 数 


另外 ， 如 果 想 通过 反射 来 调用 函数 ， 可 以 直接 使 用 call0 函 数 : 
f.call (sword, id) 


上 面 的 代码 等 价 于 : 


f.javaMethod?.invoke (sword, id) 


到 这 里 ， 我 们 就 完成 了 一 个 简单 的 注解 处 理 器 。 完 整 的 代码 如 下 : 


fun testAnnoProcessing() { 
val sword = SwordTest() 
// val kClasss:KClass<out SwordTest> = sword::class // 类 型 声明 可 省 略 
val kClass = sword::class 


val declaredFunctions = kClass.declaredFunctions // 获 取 sword 对 象 类 型 所 
声明 的 所 有 函数 


println (declaredFunctions) 


for (f in declaredFunctions) { 
// 处 理 TestCase 注解 ， 使 用 其 中 的 元 数据 
f.annotations.forEach { 
if (it is TestCase) { 
val id = it.id 
doSomething (id) // 注 解 处 理 逻 辑 
f.call(sword, id) // 等 价 于 £.javaMethod?.invoke(sword, id) 
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i 


private fun doSomething(id: String) { 
println("Do Something in Annotation Processing ${id} ${Date()} ") 
} 


@Target (AnnotationTarget.CLASS, 
AnnotationTarget . FUNCTION, 
AnnotationTarget.VALUE PARAMETER, 
AnnotationTarget .EXPRESSION) 

@Retention (AnnotationRetention. RUNTIME) 

@Repeatable 

@MustBeDocumented 

annotation class TestCase(val id: String) 


class SwordTest { 


@TestCase(id = "1") 
fun testCase(testId: String) { 
println("Run SwordTest ID = ${testId}") 

} 

} 

测试 代码 如 下 : 

fun main(args: Array<String>) { 
testAnnoProcessing() 


} 
输出 如 下 : 


[fun com.easy.kotlin.annotation.SwordTest.testCase(kotlin.String): kotlin.Unit] 
Do Something in Annotation Processing 1 Mon Oct 23 23:04:09 CST 2017 
Run SwordTest ID = 1 
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在 前 面 的 注解 信息 的 获取 与 处 理 逻 辑 的 实现 中 ， 其 实 已 经 用 到 了 反射 。 反 射 是 指 在 运 
行 时 (Run Time) ， 程 序 可 以 访问 、 检 测 和 修改 它 本 身 状 态 或 行为 的 一 种 能 力 。Kotlin 中 
的 函数 和 属性 也 是 头等 公民 ， 我 们 可 以 通过 反射 来 内 省 属性 和 函数 ， 如 运行 时 属性 名 或 类 
型 ， 函 数 名 或 类 型 等 。 

在 Kotlin 中 我 们 有 两 种 方式 来 实现 反射 的 功能 。 一 种 是 调用 Java 的 反射 包 
java.lang.reflect 下 面 的 API, 另外 一 种 方式 就 是 直接 调用 Kotlin 语言 提供 的 kotlin.reflect 包 
下 面 的 API。 不 过 因为 反射 功能 的 应 用 场景 并 非 所 有 编程 场景 都 用 到 ， 所 以 Kotlin 把 
kotlin reflect 包 的 实现 放 到 了 单独 的 kotlin-reflect-1.1.50.jar (当前 版 本 号 是 1.1.50) 里 面 。 
在 实际 工程 中 ， 如 果 需 要 使 用 Kotlin 的 反射 功能 ， 以 Grade 为 例 ， 需 要 在 build.gradle Wi 
置 文件 中 添加 以 下 依赖 : 


compile "org.jetbrains.kotlin:kotlin-reflect:$kotlin version" 
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Kotlin 反射 API 类 的 层次 结构 如 图 12-1 所 示 。 


KAnnotatedElement Annotation 
a | KType 
KClasee KParameter | 一 |] KCallable | 


| K TypeParameter 


I KVariance 


KClassifier KDeclarationContainer| KFunction K Property 


图 12-1 Kotlin 反射 API 类 的 层次 结构 


KvVisibility 


12.3.1 类 引用 


为 了 方便 讲解 ， 首 先 定义 一 个 代码 实例 : 


open class BaseContainer<T> 


class Container<T : Comparable<T>> : BaseContainer<Int> { 
var elements: MutableList<T> 


constructor (elements: MutableList<T>) { 
this.elements = elements 


} 


fun sort(): Container<T> { 
elements.sort () 
return this 


} 


override fun toString(): String { 
return "Container (elements=$elements) " 


} 


反射 是 在 运行 时 获取 一 个 类 引用 。 我 们 已 经 知道 使 用 ::class 调用 可 以 获取 到 当前 对 象 
的 KClass 对 象 : 


val container = Container (mutableListOf<Int>(1, 3, 2, 5, 4, 7, 6)) 
val kClass = container::class // 获 取 KClass WE 


需要 注意 的 是 ，Kotlin 中 类 引用 和 Java 中 的 类 引用 是 不 同 的， 要 获得 Java 类 的 引用 ， 
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可 以 直接 使 用 javaClass 这 个 扩展 属性 。 
val jClass = container.javaClass // 获 取 Java Class WR 
javaClass 扩展 属性 在 Kotlin 中 的 实现 源码 如 下 : 


public inline val <T: Any> T.javaClass : Class<T> 
@Suppress ("UsePropertyAccessSyntax") 
get() = (this as java.lang.Object) .getClass() as Class<T> 


或 者 使 用 KClass 实例 的 .java 属性 : 


val jkCLass = kClass.java 


KClass.java 的 扩展 属性 实现 源码 如 下 : 


@Suppress ("UPPER BOUND VIOLATED") 
public val <T> KClass<T>.java: Class<T> 
@JvmName ("getJavaClass") 
get() = (this as ClassBasedDeclarationContainer) .jClass as Class<T> 


12.3.2 ”函数 引用 


例如 ， 有 一 个 简单 地 判断 一 个 Int 整数 是 否 是 奇数 的 函数 : 
fun isOdd(x: Int) = x % 2 !=0 


可 以 在 代码 中 直接 调用 : 


>>> isOdd(7) 
true 

>>> isOdd(2) 
false 


另外 ， 在 高 阶 函 数 中 如 想 把 它 当 作 一 个 参数 来 使 用 ， 可 以 使 用 “::” 操 作 符 。 例 如 ; 


val nums = listOf(1, 2, 3) 
val filteredNums = nums.filter(::isOdd) 
println(filteredNums) //[1, 3] 


这 里 的 ::isOdd 就 是 一 个 函数 类 型 (Int)->Boolean 的 值 。 
12.3.3 属性 引用 


在 Kotlin 中 ,访问 属性 属于 第 一 级 对 象 ， 可 以 使 用 “::” 操 作 符 : 


var one = I 

fun testReflectProperty() { 
printlin(::one.get()) E 
"one, Set (2) 
Println (one) 1/2 

} 


fun main(args: Array<String>) { 
testReflectProperty () 
$ 
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表达 式 ::one 等 价 于 类 型 为 KProperty 的 一 个 属性 , 它 可 以 允许 我 们 通过 get0 函 数 获取 
值 ::one.get()。 

对 于 可 变 属性 varone=1， 返 回 类 型 为 KMutableProperty 的 值 ， 并 且 还 有 set 方 
法 ::one.set(2)。 


12.3.4” 绑 定 函 数 和 属性 引用 


我 们 可 以 引用 一 个 对 象 实 例 的 方法 。 例 如 下 面 的 代码 : 


val digitRegex = "\\d+".toRegex () 
digitRegex.matches ("7") //true 
digitRegex.matches ("6") //true 
digitRegex.matches ("5") //true 
digitRegex.matches("X") //false 


Ht, digitRegex.matches 重复 出 现 ， 显 得 比较 “样板 化 ”。 在 Kotlin 中 可 以 直接 引用 
digitRegex 对 象 实例 的 matches0) 方 法 。 上 面 的 代码 可 以 写成 下 面 这 样 : 


val isDigit = digitRegex::matches // 引 用 digitRegex 对 象 实例 的 matches () 方 法 


isDigit ("7") //true 
isDigit ("6") //true 
isDigit ("5") //true 
isDigit ("X") //true 


是 不 是 很 酷 ? 真 的 是 相当 简洁 。 


12.4 使 用 反射 获取 泛 型 信息 


在 Java 中 ， 使 用 反射 的 一 个 代码 实例 如 下 : 
package com.easy.kotlin; 


import java.lang.annotation.Annotation; 

import java.lang.reflect.Field; 

import java.lang.reflect.InvocationTargetException; 
import java.lang.reflect.Method; 

import java.util.Arrays; 

import java.util.List; 


interface StudentService<T> { 
List<T> findStudents (String name, Integer age); 


} 


public class ReflectionDemo { 
public static void main(String[] args) { 
StudentServiceImpl studentService = new StudentServicelImp1l (); 
studentService.save(new Student ("Bob", 20)); 
studentService.findStudents ("Jack", 20); 


// 反 射 API 调用 示例 


final Class<? extends StudentServiceImpl> studentServiceClass = 
studentService.getClass(); 
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} 


class 


Class<?>[] classes = studentServiceClass.getDeclaredClasses(); 
Annotation[] annotations = studentServiceClass.getAnnotations (); 
ClassLoader classLoader = studentServiceClass.getClassLoader(); 
//Returns the class loader for the class 
Field[] fields = studentServiceClass.getDeclaredFields(); 
// 获 取 类 成 员 变量 
Method[] methods = studentServiceClass.getDeclaredMethods () ; 
// 获 取 类 成 员 方法 
try { 
methods [0].getName(); //save 
methods [0].invoke(studentService, "Jack",20); 
} catch (IllegalAccessException e) { 
e.printStackTrace(); 
} catch (InvocationTargetException e) { 
e.printStackTrace(); 


} 


StudentServiceImp1 extends BaseService<Student> implements 


StudentService<Student> { 
public List<Student> findStudents (String name, Integer age) { 


} 


return Arrays.asList (new Student[] {new Student("Jack", 20), new 
Student ("Rose", 20)}); 


@Override 
public int save(Student student) { 


} 
} 


return 0; 


abstract class BaseService<T> { 
abstract int save(T t); 


} 


class Student { 


String name; 
Integer age; 


public Student (String name, Integer age) { 


} 


this.name = name; 
this.age = age; 


public String getName() { 


} 


return name; 


public void setName(String name) { 


} 


this.name = name; 


public Integer getAge() { 


上 


return age; 


public void setAge(Integer age) { 


} 


this.age = age; 


和 


Kotlin 从 入 门 到 进 阶 实 战 


} 
通过 反射 ， 可 以 获取 一 个 类 的 注解 、 方 法 、 成 员 变 量 等 。 那 么 能 不 能 通过 反射 获取 到 


泛 型 的 信息 呢 ? 我 们 知道 Java 中 的 泛 型 采用 擦拭 法 。 在 程序 运行 时 ， 无 法 得 到 自己 本 身 


的 泛 型 信息 。 而 当 这 个 类 继承 了 一 个 父 类 ， 父 类 中 有 泛 型 的 信息 时 ， 那 么 就 可 以 通过 调 所 
getGenericSuperclass() 方 法 得 到 父 类 的 泛 型 信息 。getGenericSuperclass0 是 Generic 继承 的 特 
例 ， 对 于 这 种 情况 子 类 会 保存 父 类 的 Generic 参数 类 型 ， 返 回 一 个 ParameterizedType. D 
外 ,我 们 所 说 的 Java 泛 型 在 字 节 码 中 会 被 擦 除 ， 并 不 总 是 擦 除 为 Object AY, MERRE 
上 限 类 型 。 


在 Kotlin 也 是 一 样 的 泛 型 机 制 。 所 以 ， 通 过 反射 能 拿 到 的 也 只 能 是 有 继承 父 类 泛 型 信 


息 的 子 类 泛 型 。 具 体 的 代码 示例 如 下 : 


class A<T> 


open class C<T> 
class B<T> : C<Int>() // 继 承 父 类 C<Int>() 


fun fooA() { 
// 无 法 在 此 处 获得 运行 时 了 的 具体 类 型 !: 下 面 的 代码 运行 时 会 报错 
val parameterizedType = A<Int>()::class.java.genericSuperclass as 
ParameterizedType 
val actualTypeArguments = parameterizedType.actualTypeArguments 
for (type in actualTypeArguments) { 
val typeName = type.typeName 
println("typeName = ${typeName}") // 运 行 会 报错 : java.lang.Class cannot 
be cast to java.lang.reflect.ParameterizedType 


fun fooB() { 
// 当 继承 了 父 类 C<Int> 的 时 候 ， 在 此 处 能 够 获得 运行 时 genericSuperclass 了 的 具体 类 型 
val parameterizedType = B<Int>()::class.java.genericSuperclass as 
ParameterizedType 
val actualTypeArguments = parameterizedType.actualTypeArguments 
for (type in actualTypeArguments) { 
val typeName = type.typeName 
println("typeName = ${typeName}") // 输 出 : typeName = java.lang. Integer 


} 


fun main(args: Array<String>) { 
fooA() 
fooB() 

j; 


下 面 通过 一 个 简单 的 实例 来 说 明 Kotlin 中 的 反射 怎样 获取 泛 型 代码 的 基本 信息 。 
首先 声明 一 个 父 类 BaseContainer: 


open class BaseContainer<T> 
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然后 声明 一 个 Container> 继承 该 父 类 : 


class Container<T : Comparable<T>> : BaseContainer<Int> { 
var elements: MutableList<T> 


constructor (elements: MutableList<T>) { 
this.elements = elements 


fun sort(): Container<T> { 
elements.sort () 
return this 


} 


override fun toString(): String { 
return "Container (elements=$elements)" 


ji 
} 


再 声明 一 个 Container 对 象 实例 : 

val container = Container (mutableListOf<Int>(1, 3, 2, 5, 4, 7, 6)) 
然后 获取 container 的 KClass 对 象 引用 : 

val kClass = container::class // 获 取 Kclass WR 

KClass 对 象 的 typeParameters 属性 中 存 有 类 型 参数 的 信息 ， 代 码 示例 如 下 : 


val typeParameters = kClass.typeParameters // 获 取 类 型 参数 typeParameters 信 
息 ， 也 即 泛 型 信息 


这 个 typeParameters 是 一 个 数组 ， 我 们 取 第 一 个 对 象 : 
val kTypeParameter: KTypeParameter = typeParameters [0] 


对 象 kTypeParameter 的 属性 有 name, ebe Bed, upperBounds 和 variance 等 ， 代 码 示 
例如 下 : 


println(kTypeParameter.isReified) // 输 出 : false 

println (kTypeParameter .name) // 输 出 : T 

println (kTypeParameter .upperBounds) // 输 出 : [kotlin.Comparable<T>] 
print1n(kTypeParameter.variance) // 输 出 : INVARIANT 


KClass 的 constructors 属性 中 存 有 构造 函数 的 信息 ， 可 以 从 中 获取 构造 函数 的 入 参 等 
信息 。 


val constructors = kClass.constructors 
for (KFunction in constructors) { 
KFunction.parameters.forEach { 
val name = it.name 
val type = it.type 
println ("name = ${name}") // 输 出 : elements 
println ("type = ${type}") // 输 出 : kotlin.collections.MutableList<T> 
for (KTypeProjection in type.arguments) { 
println(KTypeProjection.type) // 输 出 : T 
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125 本 章 小 结 


使 用 注解 与 反射 可 以 编写 出 功能 强大 的 代码 ， 可 以 在 运行 时 动态 分 析 获取 类 的 结构 信 
息 ， 可 以 对 类 进行 自 查 。Kotlin 的 反射 API 与 Java 基本 类 似 ， 在 一 些 细 节 上 有 点 差异 。 在 
前 面 的 章节 中 已 经 学 习 了 Kotlin 语言 本 身 的 知识 ， 在 后 面 的 章节 中 将 介绍 使 用 
Kotlin+Spring Boot 进行 服务 端 开发 、 使 用 Kotlin 进行 Android 移动 端 开发 等 相关 内 容 。 
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本 章 介绍 Kotlin 服务 端 开发 的 相关 内 容 。 首先 简单 介绍 一 下 Spring Boot 服务 端 开发 杠 
架 ， 快 速 给 出 一 个 Restful Hello World 的 示例 。 然 后 讲 下 Kotlin 集成 Spring Boot 进行 服 
务 端 开发 的 步 又， 最 后 给 出 一 个 完整 的 Web 应 用 开发 实例 。 


13.1 用 Spring Boot 快速 开发 Restful Hello World 


Spring Boot 大 大 简化 了 使 用 Spring 框架 过 程 中 各 种 烦琐 的 配置 。 另 外 可 以 更 加 方便 地 
整合 常用 的 工具 链 《〈 如 Redis, Email, kafka, ElasticSearch, MyBatis 和 JPA) 等 ， 缺 点 是 
集成 度 


高 (事物 都 是 两 面 性 的 ) ， 使 用 过 程 中 不 容易 了 解 底层 ， 遇 到 问题 时 解决 曲线 比 
较 陡峭 。 本 节 将 介绍 怎样 快速 开始 Spring Boot 服务 端的 开发 。 


13.1.1 Spring Initializr 


工 欲 善 其 事 必 先 利 其 器 。 我 们 使 用 https://start.spring.io/ 可 以 直接 自动 生成 Spring Boot 
项 目 脚手架 ， 如 图 13-1 所 示 。 


SPRING INITIALIZR 


Generate a menrrojces with — + and Spring Boot :ss 


Project Metadata Dependencies 


Artifact coordinates dependencies to your application 


Group 
con.cxanple 
Artifact Selected Dependencies 
dono 
Generate Project * + + 
Don't know what to lock for? Want more options? Switch to the full version 


图 13-1 使 用 Spring Initializr 生成 项 目 


单 击 Switch to the full version 链接 ， 可 以 看 到 脚手架 支持 的 工具 链 。 我 们 也 可 以 自己 
搭建 本 地 的 Spring Initializr 服务 ， 步 骤 如 下 : 
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(1) Gitclone 源码 到 本 机 https://github.com/spring-io/initializr. 
(2) 在 源码 根 目 录 下 执行 $./mvnw clean install. 
(3) 到 initializr-service 子 项 目的 日 录 下 


cd initializr-service 


执行 
.-/mvnw spring-boot:run 

即 可 看 到 启动 日 志 : 
s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port (s) : 8080 (http) 
i.s.i.service.InitializrService : Started InitializrService in 


15.192 seconds (JVM running for 15.882) 


此 时 ， 用 本 机 浏览 器 访问 http://127.0.0.1:8080/， 即 可 看 到 脚手架 initialize 页 面 。 
13.1.2 ”创建 Spring Boot 项 目 


下 面 使 用 本 地 搭建 的 脚手架 initializr 来 创建 基于 Gradle 构建 的 Kotlin + Spring Boot 项 
目 ， 如 图 13-2 所 示 。 


Generate a Grcierrojects With «oun + and Spring Boot 20.01snarsuons 


Project Metadata Dependencies 
Artifact coordinates Add Spring Boot Starters and dependencies to your application 
Group ‘Search for dependencies 
Artifact Selected Dependencies 
kotlin-with-apringboot | we | 
Name 


kotlin-with-springboot 


Description 


Demo project for Spring Boot Using Kotlin 


Package Name 


com.easy. kot lin-kotlinwithspringboot 


Packaging 


Jar 


Java Version 


18 


‘Too many options? Switch back to the simple version 


Generate Project * + = 


图 13-2 创建 基于 Grade 构建 的 Kotlin + Spring Boot 项 目 


首先 ， 我 们 选择 生成 的 是 一 个 使 用 Gradle 构建 的 Kotlin 项 目 ，SpringBoot 的 版 本 号 这 
里 选择 2.0.0(SNAPSHOT). 
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在 Spring Boot Starters 和 dependencies 选项 中 , 选择 Web starter, 这 个 启动 器 里 面包 含 
了 基本 够 用 的 Spring Web 开发 需要 的 东西 : Tomcat 和 Spring MVC. 

其 余 的 项 目 元 数据 (Project Metadata) 的 配置 (Bill Of Materials) ， 可 以 从 图 13-2 中 
看 到 。 然 后 单 击 Generate Project 按钮 ， 会 自动 下 载 一 个 项 目的 zip 压缩 包 ， 将 其 解压 导入 
IDEA 中 ， 如 图 13-3 所 示 。 


8 e import Project 
Gradle project: | ~/springboot/kotlin-with-springboot B 
Use auto-import 
Create directories for empty content roots automatically 
Create separate module per source set 
` Store generated project files externally 
Use default gradle wrapper (recommended) 
Use gradle wrapper task configuration @ Cradle wrapper customization in script, works with Grade 1,7 or later 
© Use local gradle distribution 
Gradle home: /Users/jack/soft/gradle-4.1-20170615 | 图 
Gradle JVM: Ba 1.8 (Java version 1.8.0_40", path: /Library/Java/JavaVirtual...es/jdk1.8,0_40/Contents/Home) B 
Project format: «idea (directory based) B 
` Global Gradle settings 
2) | Cancel | Previous | 


UH 


图 13-3 解压 工程 导入 IDEA 4 


因为 我 们 使 用 的 是 Gradle 构建 项 目 ， 所 以 需要 配置 一 下 Gradle 环境 。 这 里 使 用 的 是 
Local gradle distribution， 因 此 选择 对 应 本 地 的 Gradle 软件 包 目 录 。 


1. 工程 文件 目录 树 
我 们 将 得 到 下 面 的 一 个 样板 工程 ， 工 程 文件 目录 树 如 下 : 


kotlin-with-springboot$ tree 


[LE build 

| [一 kotlin-build 

| L— version.txt 
L-— build.gradle 


|— gradle 
L_ wrapper 
| PP 


| | 一 gradle-wrapper.jar 


ss 
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| L— gradle-wrapper.properties 


| 一 gradlew 
| 一 gradlew.bat 


| 一 kotlin-with-springboot.iml 


| 

| L— easy 

| L— kotlin 

| L— kotlinwithspringboot 

| L— kotlinWithSpringbootApplication.kt 
L— resources 

|ļ— application.properties 

| 一 static 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| L— templates 
— 


L— kotlin 

L— kotlinwithspringboot 
| L— kotlinWithSpringbootApplicationTests.kt 
L— resources 


23 directories, 10 files 


H, src\main\kotlin 是 Kotlin 源码 放置 日 录 。src\main\resources 目录 下 面 放 置 工程 资 
源 文件 。application.properties 是 工程 全 局 的 配置 文件 ，static 文件 夹 下 面 放置 的 是 静态 资源 
文件 ，templates 目录 下 面 放置 的 是 视图 模板 文件 。 


2. build.gradle 配置 文件 


我 们 使 用 Gradle 来 构建 项 目 。 其 中 ，build.gradle 配置 文件 类 似 Maven 中 的 pom.xml 
配置 文件 。 使 用 Spring Initializr 自动 生成 的 样板 项 目的 默认 配置 如 下 : 


buildscript { 
ext { 
kotlinVersion = '1.1.51' 
springBootVersion = '2.0.0.BUILD-SNAPSHOT' 
} 
repositories { 
mavenCentral () 
maven { url "https://repo.spring.io/snapshot" } 
maven { url "https://repo.spring.io/milestone"™ } 
} 
dependencies { 
classpath ("org.springframework.boot :spring-boot-gradle-plugin:$ 
{springBootVersion}") 
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classpath ("org.jetbrains.kotlin:kotlin-gradle-plugin: ${kotlinVersion}") 
classpath ("org.jetbrains.kotlin:kotlin-—allopen:${kotlinVersion}") 


i 


apply plugin: 'kotlin' 

apply plugin: 'kotlin-spring' 

apply plugin: ‘eclipse' 

apply plugin: 'org.springframework.boot' 

apply plugin: 'io.spring.dependency-management'" 


group = 'com.easy.kotlin' 
version = '0.0.1-SNAPSHOT' 
sourceCompatibility = 1.8 
compileKotlin { 


kotlinOptions.jvmTarget = "1.8" 
J 
compileTestKotlin { 
kotlinOptions.jvmTarget = "1.8" 


} 


repositories { 
mavenCentral () 
maven { url "https://repo.spring.io/snapshot" } 
maven { url "https://repo.spring.io/milestone" } 


} 


dependencies { 
compile ('org.springframework.boot:spring-boot-starter-web') 
compile ("org.jetbrains.kotlin:kotlin-stdlib-jre8:${kotlinVersion}") 
compile ("org.jetbrains.kotlin:kotlin-reflect:${kotlinVersion}") 
testCompile ('org.springframework. boot :spring-boot-starter-test') 


} 


HEF, spring-boot-gradle-plugin 是 Spring Boot 集成 Gradle 的 插件 ; kotlin-gradle-plugin 
是 Kotlin 集成 Gradle 的 插件 ; kotlin-allopen 是 Kotlin 集成 Spring 框架 把 类 全 部 设置 为 open 
的 插件 。 

因为 Kotlin 的 所 有 类 及 其 成 员 默 认 情况 下 都 是 final (不 可 继承 ) 的 ， 也 就 是 说 你 想 要 
继承 一 个 类 ， 就 要 不 断 地 写 各 种 修饰 符 来 打开 类 为 可 继承 的 。 而 使 用 Java 写 的 Spring 框架 
中 大 量 使 用 了 继承 和 歼 写 ， 这 个 时 候 使 用 kotlin-allopen 插件 结合 kotlin-spring 插件 ， 可 以 
自动 把 Spring 相关 的 所 有 注解 的 类 都 设置 为 open。 

spring-boot-starter-web 就 是 Spring Boot 中 提供 的 使 用 Spring 框架 进行 Web 应 用 开发 
的 启动 器 。 

kotlin-stdlib-jre8 是 Kotlin 使 用 Java 8 的 库 ，kotlin-reflect 是 Kotlin 的 反射 库 。 

Spring Boot 项 目的 整体 依赖 情况 如 图 13-4 所 示 。 

可 以 看 出 ，spring-boot-starter-web 中 已 经 引入 了 我 们 所 需要 的 JSON, Tomcat, 
Validator. Web MVC (其 中 引入 了 Spring 框架 的 核心 Web、Context、AOP、Beans、 


Expressions, Core) 等 框架 。 


sig 
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ith-springboot -import enabled) 
= Source Sets 
Y Ba main 
v BDependencies 
vil, org.springframework.boot:spring-boot-starter-web:2.0.0.BUILD-SNAPSHOT (Compile) 
> "ir org.springframework.boot:spring-boot-starter—json:2.0.0.BUILD-SNAPSHOT (Compile) 
> |i) org.springframework.boot:spring-boot-starter:2.0.0.BUILD-SNAPSHOT (Compile) 
了 (il) org.springframework.boot:spring-boot-starter-tomcat:2.0.0.BUILD-SNAPSHOT (Compile) 
» |i) org.apache.tomcat.embed:tomcat-embed-websocket:8.5.23 (Compile) 
» |i) org.apache.tomcat.embed:tomcat-embed-core:8.5.23 (Compile) 
Wi org.apache.tomcat.embed:tomcat-embed-el:8.5.23 (Compile) 
» Wir org.hibernate.validator:hibernate-validator:6.0.3.Final (Compile) 
vil) org.springframework:spring-webmvc:5.0.1.BUILD-SNAPSHOT (Compile) 
Wi org.springframework:spring-web:5.0.1.BUILD-SNAPSHOT (Compile) 
til org.springframework:spring-context:5.0.1.BUILD-SNAPSHOT (Compile) 
Wi org.springframework:spring-aop:5.0.1.BUILD-SNAPSHOT (Compile) 
ill) org.springframework:spring-beans:5.0.1.BUILD-SNAPSHOT (Compile) 
il org.springframework:spring-expression:5.0.1.BUILD-SNAPSHOT (Compile) 
Wi org.springframework:spring-core:5.0.1.BUILD-SNAPSHOT (Compile) 
{il org.springframework:spring-web:5.0.1.BUILD-SNAPSHOT (Compile) 
Y ti,orgjetbrains.kotlin:kotlin-stdlib-jre8:1.1.51 (Compile) 
Y Wir org.jetbrains.kotlin:kotlin-stdlib-jre7:1.1.51 (Compile) 
iil) org.jetbrains.kotlin:kotlin-stdlib:1.1.51 (Compile) 
v |ihorg.jetbrains.kotlin:kotlin-stdlib:1.1.51 (Compile) 
il) org.jetbrains:annotations:1 3.0 (Compile) 
Y Vir org.jetbrains.kotlin:kotlin-reflect:1.1.51 (Compile) 
ii) org.jetbrains.kotlin:kotlin-stdlib:1.1.51 (Compile) 


图 13-4 Spring Boot 项 目的 整体 依赖 情况 


3. Spring Boot 项 目的 入 口 类 KotlinWithSpringbootApplication 


自动 生成 的 Spring Boot 项 目的 入 口 类 KotlinWithSpringbootApplication 如 下 : 
package com.easy.kotlin.kotlinwithspringboot 


importorg.springframework.boot.SpringApplication 
import org.springframework.boot .autoconfigure.SpringBootApplication 


@SpringBootApplication 
class KotlinWithSpringbootApplication 


fun main(args: Array<String>) { 
SpringApplication. run (KotlinWithSpringbootApplication::class.java, *args) 
} 


HEF, @SpringBootApplication 注解 是 3 个 注解 的 组 合 ， 分 别 是 @SpringBootConfiguration 
后 台 使 用 的 @Configuration、@EnableAutoConfiguration 和 @ComponentScan 。 
于 这 些 注解 一 般 都 是 一 起 使 用 , 因此 Spring Boot 提供 了 这 个 @SpringBootApplication 
统一 的 注解 。 该 注解 的 定义 源码 如 下 : 

@Target ({ElementType.TYPE}) 

@Retention (RetentionPolicy.RUNTIME) 

@Documented 

@Inherited 


@SpringBootConfiguration 
@EnableAutoConfiguration 
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@ComponentScan ( 
excludeFilters = {@Filter( 
type = FilterType.CUSTOM, 
classes = {TypeExcludeFilter.class} 
), @Filter ( 
type = FilterType.CUSTOM, 
classes = {AutoConfigurationExcludeFilter.class} 
1) 
) 
public @interface SpringBootApplication { 


} 


main() 函数 中 的 KotlinWithSpringbootApplication::class.java 是 一 个 使 用 反射 获取 
KotlinWithSpringbootApplication 类 的 Java Class 引用 。 这 也 正 是 我 们 在 依赖 中 引入 
kotlin-reflect 包 的 用 途 所 在 。 


4. 写 Hello World 控 制 器 


下 面 我 们 来 实现 一 个 简单 的 Hello World 控 制 器 。 首 先 新 建 HelloWorldController Kotlin 
类 ， 代 码 实现 如 下 : 
package com.easy.kotlin.kotlinwithspringboot 
import org.springframework.stereotype.Controller 


import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.ResponseBody 


@Controller 
class HelloWorldController { 


@RequestMapping ("/") 

@ResponseBody 

fun home(): String { 
return "Hello World!" 


} 
} 
5. 启动 运行 


系统 默认 端口 号 是 8080， 我 们 在 application.properties 中 添加 一 行 服务 端口 号 的 配置 。 


server.port=8000 


然后 直接 启动 入 口 类 KotlinWithSpringbootApplication， 可 以 看 到 启动 日 志 。 


...0.5.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port (s): 8000 (http) 
.e.k.k.KotlinWithSpringbootApplicationKt : Started KotlinWithSpringboot- 
ApplicationKt in 7.944 

seconds (JVM running for 9.049) 


也 可 以 选择 IDEA 的 Gradle 工具 栏 里 的 Taskslapplication|bootRun 命令 来 启动 程序 ， 如 
图 13-5 所 示 。 
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Gradle projects 4 


Dr: zë: ti G 
y @kotlin-with-springboot (auto-import enabled) 
> :Source Sets 
了 CaTasks 
Caapplication 
t ur 


4 


CG build 
Ea build setup 

Ea documentation 
fghelp 

Egide 

fgother 
Caverification 


AAA 


uoneplleA ueag @ ` spafold use I apen asequieg llil sui6nig TÈ 


图 13-5 选择 Gradle 的 bootRun 


启动 完毕 后 ， 直 接 在 浏览 器 中 打开 http://127.0.0.1:8000/， 可 以 看 到 浏览 器 中 输出 了 
Hello World!， 如 图 13-6 所 示 。 


(ET < HE 127.0.0.1:8000 ER E 


Hello World! 


图 13-6 在 浏览 器 中 输出 Hello World! 


本 节 项 目 源码 地 址 是 https://github.com/EasySpringBoot/kotlin-with-springboot。 

下 面 将 使 用 Kotlin + Spring Boot 框架 实现 一 个 简单 的 图 片 仆 虫 的 Web 应 用 实例 。 上 
面 我 们 已 经 看 到 了 使 用 Kotlin 集成 Spring Boot 框架 开发 的 基本 步骤 。 下 面 将 给 出 一 个 
Kotlin 集成 Spring Boot 开发 框架 , 使 用 MySQL 数据库 、Spring Data JPA 框架 、Freemarker 
模板 引擎 的 完整 Web 项 目的 实例 。 首 先 我 们 来 简单 介绍 一 下 系统 的 技术 栈 。 
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13.2 ”系统 功能 与 技术 栈 


本 节 介 绍 使 用 Kotlin 集成 Spring Boot 框架 开发 一 个 完整 的 图 片 仆 虫 Web 应 用 , 基本 
功能 如 下 : 
口 定时 抓 取 图 片 搜索 API 根据 关键 字 搜索 返回 的 图 片 JSON 信息 ， 解 析 入 库 : 
O We 页 面 分 页 展示 图 片 列表 ， 支 持 收藏 、 删 除 等 功能 ; 
口 列表 支持 根据 图 片 分 类 进行 模糊 搜索 。 
涉及 的 主要 技术 栈 有 如 下 几 种 。 
编程 语言 : Kotlin; 
数据 库 层 : MySQL, mysql-jdbc-driver, JPA; 
企业 级 开发 框架 : Spring Boot. Spring MVC; 
视图 层 模 板 引 擎 : Freemarker; 
前 端 框 架 jQuery, Bootstrap, Bootstrap-table; 
工程 构建 工具 : Gradle。 
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133 准备 工作 


使 用 Spring Initializr 创建 项 目 ， 首 先 配 置 项 目 基本 信息 和 依赖 ， 如 图 13-7 所 示 。 


Generate a crate Pies: With sen: : and Spring Boot 2oosnarshon s 


Project Metadata Dependencies 
artifact coordinates Add Spring Boot Starters anc dependencies to your application 
Group ‘Search for dependencies 
con.easy .kotlin Mab, Security, JPA, Actuator, Devtcois... 
Arifact Selected Dependencies 
Name 


picture-crawler 


Description 


Dono project for Spring Boot 


Package Name 


com. easy. kot lin.picturecrawler 


Packaging 


Jar 


Java Version 


18 


‘Too many options? Switch back to the simple version 


Generate Project = + = 


图 13-7 配置 项 目 基本 信息 和 依赖 


“Es 


Kotlin 从 入 门 到 进 阶 实 战 


自动 生成 项 目 源码 工程 ， 导 入 IDEA 中 ， 等 构建 完毕 后 将 得 到 下 面 的 工程 目录 : 


picture-crawler$ tree 


build.gradle 
gradle 


L— wrapper 
gradle-wrapper.jar 
gradle-wrapper.properties 
gradlew 
gradlew.bat 
picture-crawler.iml 
SEC 
main 
java 
kotlin 
L— com 
[一 easy 
L— kotlin 
[一 picturecrawler 
L— PictureCrawlerApplication.kt 
resources 
application .properties 
static 
templates 
test 
java 
kotlin 
[一 com 
[一 easy 
L— kotlin 
L— picturecrawler 
[一 PictureCrawlerApplicationTests.kt 
resources 


21 directories, 9 files 


自动 生成 的 build.gradle 文件 如 下 : 


buildscript { 

ext { 
kotlinVersion = '1.1.51' 
springBootVersion = '2.0.0.BUILD-SNAPSHOT' 

} 

repositories { 
mavenCentral () 
maven { url "https://repo.spring.io/snapshot" } 
maven { url "https://repo.spring.io/milestone" } 

} 

dependencies { 
classpath ("org.springframework. boot: spring—boot-gradle-plugin:$ 
{springBootVersion}") 
classpath ("org.jetbrains.kotlin:kotlin-gradle-plugin:${kotlinVersion}") 
classpath ("org. jetbrains.kotlin:kotlin-allopen:${kotlinVersion}") 


} 


apply plugin: 'kotlin' 

apply plugin: 'kotlin-spring' 

apply plugin: ‘eclipse 

"apply plugin: 'org.springframework.boot' 


= 168° 


第 13 章 Kotlin 集成 Spring Boot 服务 端 开发 


apply plugin: 'io.spring.dependency-management' 


group = 
version 


"com.easy-.kotlin' 
= '0.0.1-SNAPSHOT' 


sourceCompatibility = 1.8 
compileKotlin { 


kotlinOptions.jvmTarget = "1.8" 
} 
compileTestKotlin { 
kotlinOptions.jvmTarget = "1.8" 


} 


repositories { 
mavenCentral () 
maven { url "https://repo.spring.io/snapshot" } 
maven { url "https://repo.spring.io/milestone" } 


} 


dependencies { 
compile ('org.springframework.boot :spring-boot-starter-—freemarker') 
compile ('org.springframework.boot:spring-boot-starter-data-jpa') 
compile ('org.springframework.boot :spring-boot-starter-quartz") 
compile ('org.springframework.boot:spring-boot-starter-web') 
compile ("org.jetbrains.kotlin:kotlin-stdlib-jre8:${kotlinVersion}") 
compile ("org.jetbrains.kotlin:kotlin-reflect:${kotlinVersion}") 
runtime ('mysql:mysql-connector-java') 
testCompile ('org.springframework.boot :spring-boot-starter-test') 


} 


可 以 看 到 ， 在 build.gradle 中 新 增 了 spring-boot-starter-freemarker, mybatis-spring-boot- 
starter, spring-boot-starter-quartz, mysql-connector-java 等 依赖 。 在 这 些 starter 中 已 经 封装 
了 这 个 工具 链 所 需要 的 依赖 库 。 整 个 项 目的 依赖 情况 如 图 13-8 所 示 。 


Y WDependencies 


Y tio 
> ill 


> il 
MIT 


> il 
> ill 
> ilio 
> Wo 
> o 


rg.springframework.boot:spring-boot-starter-freemarker:2.0.0.BUILD-SNAPSHOT (Compile) 
\| org.springframework.boot:spring-boot-starter-web:2.0.0.BUILD-SNAPSHOT (Compile) 

| org.springframework.boot:spring-boot-starter:2.0.0.BUILD-SNAPSHOT (Compile) 

\| org.freemarker:freemarker:2.3.26-incubating (Compile) 

\ org.springframework:spring-context-support:5.0.1.BUILD-SNAPSHOT (Compile) 
rg.springframework.boot:spring-boot-starter-data-jpa:2.0.0.BUILD-SNAPSHOT (Compile) 
\| org.springframework.boot:spring-boot-starter-aop:2.0.0.BUILD-SNAPSHOT (Compile) 

\| org.springframework.boot:spring-boot-starter-jdbc:2.0.0.BUILD-SNAPSHOT (Compile) 

| org.springframework.boot:spring-boot-starter:2.0.0.BUILD-SNAPSHOT (Compile) 

li org.hibernate:hibernate-core:5.2.12.Final (Compile) 

| javax.transaction:javax.transaction-api:1.2 (Compile) 

| org.springframework.data:spring-data-jpa:2.0.0.RELEASE (Compile) 

li org.springframework:spring-aspects:5.0.1.BUILD-SNAPSHOT (Compile) 
rg.springframework.boot:spring-boot-starter-quartz:2.0.0.BUILD-SNAPSHOT (Compile) 
rg.jetbrains.kotlin:kotlin-stdlib-jre8:1.1.51 (Compile) 
rg.jetbrains.kotlin:kotlin-reflect:1.1.51 (Compile) 


iii mysql:mysql-connector-java:5.1.44 (Runtime) 


图 13-8 ”整个 项 目的 依赖 情况 


目前 我 们 的 工程 已 经 具备 了 连接 MySQL 数据 库 、 解 析 Freemarker 的 .f 模板 文件 等 能 
力 了 。 但 是 此 时 如 果 启 动 会 报错 : 


BeanCreationException: Error creating bean with name 'dataSource' defined 
in class path 


resource 


[org/springframework/boot/autoconfigure/jdbc/ DataSourceConfiguration- 


S$Hikari.class] 


“Is 
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创建 dataSource Bean 失败 。 因 为 我 们 还 没有 配置 任何 数据 库 连接 信息 。 下 面 我 们 来 配置 数 
据 源 dataSource。 


13.4 配置 数据 层 


Spring Boot 的 数据 源 配置 在 application.properties 中 是 以 spring.datasource 为 前 级 的 。 
例如 ， 新 建 一 个 wotu Æ: 


CREATE SCHEMA 'wotu' DEFAULT CHARACTER SET utf8 ; 


配置 数据 库 的 链接 URL、 用 户 名 、 密 码 信息 如 下 : 


spring.datasource.url=jdbc:mysql://localhost:3306/wotu?zeroDateTimeBeha 
vior=convertToNullécharacterEncoding=ut f8&characterSetResults=utf8éuseS 
SL=false 

spring.datasource.username=root 

spring.datasource.password=root 


spring.datasource.testWhileIdle=true 
spring.datasource.validationQuery=SELECT 1 


然后 再 次 启动 应 用 ， 可 以 发 现成 功 启动 了 。 
13.5 ”数据 持久 层 开发 


F 面 我 们 从 数据 持久 层 开始 构建 应 用 。 首 先 来 设计 数据 库 的 表 结构 。 
13.5.1 数据 库 表 结构 


首先 设计 数据 库 的 表 结 构 如 下 : 


CREATE TABLE 'picture' ( 
"id' bigint (20) NOT NULL AUTO INCREMENT, 
"category' varchar(255) DEFAULT NULL, 
"deleted date datetime DEFAULT NULL, 
"gmt_created' datetime DEFAULT NULL, 
"gmt_modified' datetime DEFAULT NULL, 
"is deleted' int(11) NOT NULL, 
"url' varchar (500) NOT NULL, 
"version' int(11) NOT NULL, 
‘is favorite' int(11) NOT NULL, 
PRIMARY KEY ('id','url'), 
KEY ‘url' ('id','url') USING BTREE 

) ENGINE=InnoDB DEFAULT CHARSET=utf8; 


ES 


为 我 们 使 用 的 是 卫 A， 所 以 只 需要 写 好 实体 类 代码 ， 启 动 应 用 即 可 在 MySQL 数据 
库 中 自动 创建 表 结构 。 实 体 类 代码 如 下 : 


"ls 
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package com.easy.kotlin.picturecrawler.entity 


import java.util.* 
import javax.persistence.* 


@Entity 

class Image { 
@Id 
@GeneratedValue (strategy = GenerationType. IDENTITY) 
var id: Long = -1 
@Version 
var version: Int = 0 
var category: String = 
var isFavorite: Int = 0 
var url: String = "" 
var gmtCreated: Date = Date() 
var gmtModified: Date = Date() 
var isDeleted: Int = 0 //1 Yes,0 No 
var deletedDate: Date = Date() 


override fun toString(): String { 
return "Image (id=$id, version=$version, category='$category', isFavorite= 
$isFavorite, url='$url', gmtCreated=$gmtCreated, gmtModi fied=$gmtModi fied, 
isDeleted=$isDeleted, deletedDate=$deletedDate)" 


13.5.2 配置 JPA 


下 面 再 配置 一 下 IPA 的 一 些 行为 : 


spring.jpa.database=MYSQL 

spring.jpa.show-sql=true 

# Hibernate ddl auto (create, create-drop, update) 
spring.jpa.hibernate.ddl-auto=update 

# Naming strategy 

spring. jpa.hibernate.naming-strategy=org.hibernate.cfg.ImprovedNamingSt 
rategy 

spring. jpa.properties.hibernate.dialect=org.hibernate.dialect .MySQL5Dia 
lect 


1. ddl-auto 的 值 


其 中 ，spring.jpa.hibernate.ddl-auto 的 值 有 : create, create-drop, update, validate, none, 
如 表 13-1 中 分 别 进行 了 简单 的 说 明 。 
表 13-1 ddl-auto 的 值 说 明 


值 说 明 


每 次 加 载 hibernate 会 自动 创建 表 ， 以 后 启动 会 履 盖 之 前 的 表 。 所 以 这 个 值 基本 不 用 ， 因 
为 严重 的 情况 下 会 导致 数据 丢失 
re 每 次 加 载 hibernate 时 根据 model 类 生成 表 , 但 是 sessionFactory 一 关闭 表 就 自动 删除 ， 下 
-次 启动 会 重新 创建 
加 载 hibernate 时 根据 实体 类 model 创建 数据 库 表 ， 这 时 表 名 的 依据 是 @Entity 注解 的 值 
update 或 者 @Table 注解 的 值 。sessionFactory 关闭 表 不 会 删除 ， 且 下 一 次 启动 会 根据 实体 model 
更 新 结构 或 者 有 新 的 实体 类 时 创建 新 的 表 


create 


i 
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值 说 AA 
validate 启动 时 验证 表 的 结构 ， 不 会 创建 表 
none 启动 时 不 做 任何 操作 


一 般 在 开发 项 目的 过 程 中 ， 通 常会 选用 update 选项 。 
再 次 启动 应 用 ， 启 动 完毕 后 可 以 看 到 数据 库 中 已 经 自动 创建 了 image K, WE 13-9 
所 示 。 


Field + Type = Null * Key + Default = Extra H 
1 id bigint(20) NO PRI <null> auto_increment 
2 category varchar(255) YES MUL <null> 
3 deleted_date datetime YES <null> 
4 gmt_created datetime YES <null> 
5 gmt_modified datetime YES <null> 
6 is_deleted int(11) NO <null> 
7 is_favorite int(11) NO <null> 
8 url varchar(255) YES UNI <null> 
9 version int(11) NO <null> 


图 13-9 数据 库 中 已 经 自动 创建 的 image 表 


2. 声明 数据 表 的 索引 


为 了 达到 更 高 的 性 能 ， 我 们 建立 类 别 category 字段 和 url 索引 ， 其 中 url 是 唯一 索引 。 


ALTER TABLE 'sotu'.'image' 
ADD INDEX 'idx category' ('category' ASC), 
ADD UNIQUE INDEX ‘uk url' ('url' ASC); 


而 实际 上 不 需要 手工 写 上 面 的 SQL 代码 然后 再 去 数据 库 中 执行 ， 只 需要 写 下 面 的 实 
体 类 
package com.easy.kotlin.picturecrawler.entity 


import java.util.* 
import javax.persistence.* 


@Entity 
@Table (indexes = arrayOf ( 

Index(name = "idx url", unique = true, columnList = "url"), 

Index (name = "idx category", unique = false, columnList = "category") )) 
class Image { 


@Id 

@GeneratedValue (strategy = GenerationType. IDENTITY) 
var id: Long = -1 

@Version 


var version: Int = 0 
@Column (length = 255, unique = true, nullable = false) 
var category: String = "" 


var isFavorite: Int = 0 


@Column (length = 255, unique = true, nullable = false) 
var üil: String = 77 
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var gmtCreated: Date = Date() 
var gmtModified: Date = Date() 
var isDeleted: Int = 0 //1 Yes, 0 No 
var deletedDate: Date = Date() 


override fun toString(): String { 
return "Image (id=$id, version=$version, category='$category', isFavorite= 
$isFavorite, url='Surl', gmtCreated=$gmtCreated, gmtModified= 
$gmtModified, isDeleted=$isDeleted, deletedDate=$deletedDate)" 


} 


然后 在 @Table 注解 里 指定 为 url. category 建立 索引 ， 以 及 设 定 url 唯一 性 约束 
unique=true. 


@Table (indexes = arrayOf ( 
Index (name = "idx url", unique = true, columnList = "url"), 
Index (name = "idx category", unique = false, columnList = "category") )) 


启动 应 用 的 时 候 ，JPA 会 去 解析 我 们 的 注解 生成 对 应 的 SQL， 并 且 自 动 去 执行 相应 
的 SQL。 例 如， 字段 url 的 唯一 索引 约束 ， 我 们 可 以 在 启动 日 志 中 看 到 如 下 输出 : 


Hibernate: alter table image drop index idx url 
Hibernate: alter table image add constraint idx url unique (url) 


其 中 ，Index 是 @Index 注解 ， 作 为 参数 使 用 的 时 候 不 需要 加 @。 我 们 再 举 个 例子 ， 实 
体 类 代码 如 下 : 
package com.easy.kotlin.picturecrawler.entity 


import java.util.* 
import javax.persistence.* 


@Entity 
@Table (indexes = arrayOf (Index (name = "idx key word", columnList = "keyWord", 
unique = true) )) 
class SearchKeyWord { 
@Id 
@GeneratedValue (strategy = GenerationType. IDENTITY) 
var id: Long = -1 
@Column (length = 50, unique = true, nullable = false) 
var keyWord: String = "" 
var gmtCreated: Date = Date() 
var gmtModified: Date = Date() 
var isDeleted: Int = 0 //1 Yes, 0 No 
var deletedDate: Date = Date() 


启 应 用 ， 可 以 看 到 Hibemate 日 志 如 下 : 


Hibernate: create table search key word (id bigint not null auto increment, 
deleted date datetime, gmt created datetime, gmt modified datetime, 
is deleted integer not null, key word varchar (50) not null, primary key (id) ) 
engine=MyISAM 

Hibernate: alter table search key word drop index UK_lvmjkr0dkesio7a33ejre5c26 
Hibernate: alter table search key word add constraint UK_lvmjkr0dkesio7a33ej- 
re5c26 unique (key word) 


SIS 
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自动 生成 的 表 结 构 如 图 13-10 所 示 。 


Field + Type + Null = Key = Default 
1 id bigint(20) NO PRI <null> 
2 deleted_date datetime YES <null> 
3 gmt_created datetime YES <null> 
4 gmt_modified datetime YES <null> 
5 is_deleted int(11) NO <null> 
6 key_word varchar(50) NO UNI <null> 


图 13-10 ”自动 生成 的 表 结 构 


+ Extra 


auto_increment 


其 中 , @Column(length=50,unique=true, nullable=false) 这 一 句 指 定 了 keyWord 字段 的 长 


varchar(50), Null 是 NO，Key 是 唯一 键 UNI. 
3. 主键 自动 生成 策略 


我 们 使 用 @Id 注解 来 标注 主键 字段 : 
@Id 


度 是 50， 有 唯一 约束 ， 不 可 空 。 对 应 生成 的 数据 库 表 字段 key_word 信息 中 : Type 是 


@GeneratedValue (strategy = GenerationType.IDENTITY) 


var id: Long = -1 


其 中 的 @GeneratedValue(strategy=GenerationType.IDENTITY) 注 解 需要 重点 介绍 一 下 。 
这 里 的 GenerationType 是 主键 ID 的 生成 规则 。JPA 提供 的 4 种 标准 用 法 为 TABLE, 
SEQUENCE、IDENTITY、AUTO， 每 个 值 的 说 明 如 表 13-2 所 示 。 


# 13-2 ”GenerationType 的 值 说 明 


GenerationType 说 AA 
TABLE 使 用 一 个 特定 的 数据 库 表 格 来 保存 主键 
SEQUENCE 根据 底层 数据 库 的 序列 来 生成 主键 ， 条 件 是 数据 库 支持 序列 
IDENTITY 主键 由 数据 库 自动 生成 (主要 是 自动 增长 型 ) 
AUTO 主键 由 程序 控制 
设计 源码 目录 如 下 : 
src 
main 

java 

kotlin 

= com 

L— easy 
E> kotlin 


L— picturecrawler 


PictureCrawlerApplication.kt 


controller 
dao 
entity 
job 

| service 


HE, controller 包 下 面 放置 Controller 控制 器 代码 ; entity 包 下 面 放置 对 应 到 数据 库 表 
的 实体 类 代码 ; dao 包 下 面 放置 数 据 访问 层 罗 辑 代 码 ; service 包 下 面 放 置业 务 轴 辑 实现 代 


码 ; job 包 下 面 放置 定时 任务 代码 。 
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13.6 JSON 数据 解析 


我 们 的 图 片 搜索 APT 返回 的 数据 结构 是 ISON 格式 的 ， 内 容 示例 如 下 : 


"queryEnc": "%E7%BE%8E%E5%A5%B3", 
"queryExt": "美女 "， 
"listNum": 3900, 
"displayNum": 415337, 
"gsm": "Sa", 
"bdFmtDispNum": " 约 415,000", 
"bdSearchTime": "", 
"isNeedAsyncRequest": 1, 
"bdIsClustered": "1", 
"data": í 
t “adtype"= "0", 
"hasAspData": "0", 
"thumbURL": 
"http: //img5S .imgtn.bdimg.com/it/u=2817128514, 3400259638fm=27&gp=0 . jpg", 
"middleURL" : 
"http: //img5.imgtn.bdimg.com/it/u=2817128514, 340025963&fm=27 &gp=0 . jpg", 
"largeTnImageUrl": "", 
"hasLarge": 0, 


"currentIndex": "", 
"width": 800, 
"height 958, 
"type" 

Tia ngit" al 


"bdImgnewsDate": "1970-01-01 08:00", 
"fromPageTitle": "", 
"fromPageTitleEnc": 


"性 感 美女 "， 
} 


我 们 只 需要 取出 其 中 的 thumbURL 和 fromPageTitleEnc 两 个 字段 的 值 。 我 们 使 用 
fastjson 来 解析 这 个 ISON 字符 串 。 


try { 
val obj = JSON.parse(jsonstr) as Map<*, *> //(1) parse () Ax 
val dataArray = obj .get ("data") as JSONArray // (2) 取出 data 转换 成 JSONArray 
dataArray.forEach { 
val category = (it as Map<*, *>).get("fromPageTitleEnc") as String 
// (3) 获取 目标 key 
val url = it.get("thumbURL") as String // (4) 
val imageResult = ImageCategoryAndUr1l (category = category, url = url) 
imageResultList .add(imageResult) 


} 
} catch (ex: Exception) { 


} 
代码 说 明 如 下 : 


Ae 
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口 使 用 fastjson 的 ISON 类 的 parse0 方 法 来 解析 ISON 字符 串 jsonstr， 然 后 把 类 型 转 
换 成 Map<*,*>， 这 里 的 * 是 泛 型 星 号 通配符 。 

口 取出 Map 中 key 为 data 的 值 ， 它 是 一 个 数组 。 然 后 再 次 使 用 as 操作 符 把 它 转 成 
JSONArray。 

O 遍历 dataArray 中 的 元 素 it， 转 换 成 Map<*,*> 类 型 ， 然 后 取出 相应 字段 的 值 。 

口 由 于 在 第 三 步 中 已 经 将 让 转换 成 了 Map<*,*> 类 型 ， 编 译 器 已 经 记 住 了 站 转换 后 的 
类 型 ， 所 以 在 这 里 的 站 类 型 已 经 是 Map 类 型 了 ， 我 们 可 以 直接 当 作 Map 来 使 用 。 

其 中 的 ImageCategoryAndUrl 对 象 是 我 们 定义 的 数据 转换 对 象 。 


data class ImageCategoryAndUrl(val category: String, val url: String) 


搜索 图 片 的 APiBuilder 如 下 : 


object ImageSearchApiBuilder { 
fun build(word: String, page: Int): String { 
return 
"http: //image.baidu.com/search/acjson?tn=resultjson com&ipn=rj&fp=resul 
t&word=$ {word} &pn=${30 * page} érn=30" 
} 


I 
我 们 来 写 个 单元 测试 : 


package com.easy.kotlin.picturecrawler 
import com.easy.kotlin.picturecrawler.api.ImageSearchApiBuilder 


import com.easy.kotlin.picturecrawler.service.JsonResultProcessor 
import org.junit.Test 

import org.junit.runner.RunWith 

import org.junit.runners.JUnit4 


@RunWith (JUnit4::class) 
class JsonResultProcessorTest { 
@Test 
fun testJsonResultProcessor() { 
val list = JsonResultProcessor.get ImageCategoryAndUr1List (ImageSearchApi- 
Builder.build("#", 1)) 
println(list) 


} 


输出 如 下 : 


[ImageCategoryAndUrl (category= 美 女 写真 集 ， 

url=http://imgl.imgtn.bdimg.com/ it/u=3772875022,724775083&fm=27&gp=0.jpg)， 
ImageCategoryAndUrl (category= 美 女 写真 美女 美女 写真 美女 美女 写真 KK, 
url=http://img0.imgtn.bdimg.com/it/u= 3312193685, 1215837845&fm=11&gp=0.jpg), 
ImageCategoryAndUrl (category=... 


13.7 KNARE EIL 


现在 我 们 已 经 有 了 数据 的 表 结 构 和 实体 类 代码 ， 同 时 也 己 经 有 业务 源 数 据 了 。 我 们 现 
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在 要 做 的 是 把 怜 到 的 图 片 信息 存储 到 数据 库 中 ， 同 时 ， 重 复 的 url 信息 不 再 重复 存储 。 
新 建 一 个 实现 PagingAndSortingRepository 的 ImageRepository 接口 如 下 : 


interface ImageRepository : PagingAndSortingRepository<Image, Long> 


只 要 上 面 一 行 代码 ， 就 可 以 直接 使 用 ImageRepository 的 CRUD Ghi, re MER 
查询 ) 方法 了 。 因 为 JPA 框架 会 自动 生成 这 些 方法 。 下 面 代码 中 的 PagingAndSorting 
Repository 是 带 分 页 功能 的 ， 它 继承 了 CrudRepository 接口 : 


@NoRepositoryBean 
public interface PagingAndSortingRepository<T, ID> extends CrudRepository 
<T, ID> { 
Iterable<T> findAll (Sort sort); 
Page<T> findAll(Pageable pageable) ; 
} 


而 在 接口 CrudRepository 中 定义 了 我 们 能 够 直接 使 用 的 CRUD 方法 。 


@NoRepositoryBean 
public interface CrudRepository<T, ID> extends Repository<T, ID> { 
<S extends T> S save(S entity); 
<S extends T> Iterable<S> saveAll (Iterable<S> entities); 
Optional<T> findById(ID id); 
boolean existsById(ID id); 
Iterable<T> findAll(); 
Iterable<T> findAllById(Iterable<ID> ids); 
long count (); 
void deleteById(ID id); 
void delete(T entity); 
void deleteAll (Iterable<? extends T> entities); 
void deleteAll(); 
} 


我 们 入 库 就 直接 使 用 saveO(Sentity) 方 法 。 但 是 为 了 保证 重复 的 url 不 再 被 保存 ， 需 要 
写 个 函数 来 判断 在 数据 库 中 是 否 存 在 当前 URL。 我 们 直接 使 用 selectcountO 语 名 来 判断 即 
H, HHAH selectcountO 出 来 的 值 等 于 0 (表明 数据 库 中 不 存在 此 url) 时 ， 才 进行 入 库 
动作 。 在 ImageRepository 接口 中 直接 声明 函数 即 可 ， 代 码 如 下 : 


@Query("select count (*) from #{#entityName} a where a.url = :url") 
fun countByUrl (@Param("url") url: String): Int 

入 库 逻 辑 代码 如 下 : 

if (imageRepository.countByUrl(url) == 0) { 


val Image = Image () 
Image.category = category 
Image.url = url 
imageRepository. save (Image) 


13.8 定时 调度 任务 


为 了 简单 起 见 , 我 们 直接 使 用 Spring 自 带 的 scheduling 包 下 的 @Schedules 注解 来 实现 


Ss 


Kotlin 从 入 门 到 进 阶 实 战 


任务 的 定时 执行 。 需 要 注意 的 是 ， 要 在 Spring Boot 的 启动 类 上 面 添 加 注解 如 下 : 


@SpringBootApplication 
@EnableScheduling 
class PictureCrawlerApplication 


我 们 的 定时 任务 代码 如 下 : 
package com.easy.kotlin.picturecrawler.job 


import com.easy.kotlin.picturecrawler.service.CrawImageService 
import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.scheduling.annotation.Scheduled 
import org.springframework.stereotype.Component 

import java.util.* 


@Component 
class ImageCrawlerJob { 


@Autowired lateinit var CrawImagesService: CrawImageService 
@Scheduled(cron = "0 */5 * * * ?") 
fun job() { 

Println(" 开 始 执行 定时 任务 : ${Date()}") 


CrawImagesService.doCrawJob () 
} 
HH, @Scheduled(cron="0+/5444? RRE 5 分 钟 执行 一 次 图 片 的 抓 取 任 务 。 然 后 
重新 启动 应 用 ， 会 看 到 每 隔 5 分 钟 ， 定 时 任务 会 运行 一 次 。 
到 目前 为 止 ， 我 们 的 原始 数据 已 经 入 库 。 下 面 我 们 将 要 进行 控制 器 层 代 码 和 视图 展示 
层 模板 引擎 代码 开发 ， 最 后 是 前 端 页 面 展 示 部 分 的 代码 开发 。 


13.9 HTTP 接口 开发 


本 节 介绍 服务 端的 HTTP 接口 的 开发 , 通过 使 用 Spring Data IPA 提供 的 分 页 功能 来 实 
现 一 个 分 页 查询 的 后 端 HTTP 接口 。 


13.9.1 实现 分 页 查询 接口 


下 面 实现 一 个 分 页 查询 HTTP 接口 ， 这 个 接口 是 http://127.0.0.1:8000/sotuJson?page= 
10&size=3， 该 接口 返回 的 数据 是 ISON 格式 ， 代 码 如 下 : 
{ 


"content": [ 
{ 
mid": 5981, 
"version": 0, 
"category": "南非 ,动物 世界 ,非洲 地 区 旅游 景点 ,风景 名 胜 "， 
"url": "http://img0.imgtn.bdimg.com/it/u=2871771810,3599000038&fm= 
27&gp=0. jpg", 
"gmtCreated": 1508858697000, 


sis 


# 
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"gmtModified": 1508858697000, 
"deletedDate": 1508858697000 
}, 
l; 
"pageable": { 
Nsort™= f 
"sorted": true, 
"unsorted": false 
TI, 
"offset": 30; 
"pageSize": 3, 
"pageNumber": 10, 
"paged": true, 
"unpaged": false 
TI, 
"last": false, 
"totalPages": 2004, 
"totalElements": 6011, 
"size": 3; 
"numberOfElements": 3, 
"sortz f 
"sorted": true, 
"unsorted": false 


} 
"number": 10, 
"first": false 


13.9.2 @Query 注解 与 #{#entityName} 


在 Spring Data JPA 中 提供 了 基本 的 CRUD 操作 、 分 页 查询 、 排 序 等 。 我 们 先 来 实现 
ImageRepository 接口 中 的 fmndAllO 函 数 : 

@Query ("SELECT a from #{#entityName} a where a.isDeleted=0 order by a.id desc") 

override fun findAll(pageable: Pageable): Page<Image> 

其 中 ，@Query 是 JPA 中 的 查询 注解 。 

JPA 中 可 以 执行 两 种 方式 的 查询 , 一 种 是 使 用 IPQL, 另 一 种 是 使 用 Native SQL. 其 中 ， 
JPQL 是 基于 Entity 对 象 (@Entity 注解 标注 的 对 象 ) 的 查询 ， 可 以 消除 不 同 数据 库 间 SQL 
语句 上 的 差异 ， 本 地 SQL 语句 是 基于 传统 的 SQL 查询 ， 是 对 IPQL 查询 语句 的 补充 。 

在 JPQL 中 可 以 使 用 SPEL 表达 式 #{#entityName} 代 替 本 来 实体 的 名 称 , 而 Spring Data 
JPA 会 自动 根据 Image 实体 上 对 应 的 @Entityname="Image") 或 者 是 默认 的 @Entity, 自动 将 
实体 名 称 填 入 HQL 语句 中 。 

实体 类 Image 使 用 @Entity 注解 后 , Spring Data JPA 的 EntityManager 会 将 实体 类 Image 
纳入 管理 。 默 认 的 #{#entityName} 的 值 就 是 Inage， 如 果 指 定 其 中 的 
@Entity(name="Image")name 的 值 ， 那 么 #{#entityName} 就 是 指定 的 值 。 

在 JPQL 语句 中 : 


SELECT a from #{#entityName} a where a.isDeleted=0 order by a.id desc 


我 们 就 可 以 像 访问 Kotlin 类 属性 一 样 来 访问 字段 值 。 注意 , 这 里 的 a.isDeleted 是 属性 名 称 。 
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13.9.3 Pageable 5 Page 


本 节 介 绍 实现 分 页 的 两 个 关键 类 型 : Pageable 与 Page。 

1. 分 页 方法 传 入 的 Pageable 参 数 

Spring Data JPA 的 PagingAndSortingRepository 接口 已 经 提供 了 对 分 页 的 支持 , 查询 的 
时 候 我 们 只 需要 传 入 一 个 Pageable 类 型 的 实现 类 。 这 个 Pageable 接口 定义 如 下 : 

package org.springframework.data.domain; 

import java.util.Optional; 

import org.springframework.util.Assert; 

public interface Pageable { 

static Pageable unpaged() { 


return Unpaged. INSTANCE; 
} 


default boolean isPaged() { 
return true; 


} 
default boolean isUnpaged() { 
return !isPaged(); 
} 
int getPageNumber () ; 
int getPageSize(); 
long getOffset(); 
Sort getSort(); 
default Sort getSortOr(Sort sort) { 
Assert.notNull (sort, "Fallback Sort must not be null!"); 


return getSort().isSorted() ? getSort() : sort; 
} 


Pageable next(); 
Pageable previousOrFirst (); 
Pageable first(); 
boolean hasPrevious (); 
default Optional<Pageable> toOptional() { 
return isUnpaged() ? Optional.empty() : Optional.of (this); 
e } 
Spring Data JPA 中 提供 的 PageRequest 类 已 经 实现 了 Pageable 接口 ， 可 以 像 下 面 这 样 
直接 使 用 : 


val sort = Sort (Sort.Direction.DESC, "id") 
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val pageable = PageRequest.of(page, size, sort) 


HLA, Direction 是 Sort 类 中 定义 的 注解 : 


public static enum Direction { 


ASC, DESC; 
I 
Sort 类 的 构造 函数 签名 如 下 : 
public Sort (Direction direction, String... properties) { 
this(direction, properties == null ? new ArrayList<>() : Arrays.asList 


} 


(properties) ); 


这 里 Sort(Sort.Direction.DESC,"id") 传 入 的 是 根据 ID 进行 降序 排序 。 


2. 分 页 返回 类 型 Page 


findAll0 函 数 的 返回 类 型 是 Page, 这 里 的 Page 类 型 是 Spring Data JPA 分 页 结果 的 返回 
WR, Page 继承 了 Slice. Page 和 Slice 这 两 个 接口 的 定义 如 下 : 


public interface Page<T> extends Slice<T> { 


} 


static <T> Page<T> empty() { 
return empty (Pageable.unpaged() ); 
} 
static <T> Page<T> empty(Pageable pageable) { 
return new PageImpl<>(Collections.emptyList(), pageable, 0); 
} 
int getTotalPages(); 
long getTotalElements (); 
<U> Page<U> map(Function<? super T, ? extends U> converter); 


public interface Slice<T> extends Streamable<T> { 


f; 


int getNumber (); 
int getSize(); 
int getNumberOfElements () ; 
List<T> getContent (); 
boolean hasContent (); 
Sort getSort(); 
boolean isFirst(); 
boolean isLast(); 
boolean hasNext (); 
boolean hasPrevious(); 
default Pageable getPageable() { 
return PageRequest.of (getNumber(), getSize(), getSort()); 
} 
Pageable nextPageable(); 
Pageable previousPageable(); 
<U> Slice<U> map(Function<? super T, ? extends U> converter); 


这 个 分 页 对 象 Pageable 的 数据 结构 信息 足够 我 们 在 前 端 实现 分 页 交互 页 面 时 使 用 。 下 
面 来 实现 分 页 查询 所 有 image 表 记 录 的 REST API 接口 。 在 controller 包 路 径 下 新 建 
ImageController 类 ， 在 该 类 中 使 用 @Controller 注解 。 
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package com.easy.kotlin.picturecrawler.controller 


import com.easy.kotlin.picturecrawler.dao.ImageRepository 
import com.easy.kotlin.picturecrawler.entity. Image 

import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.data.domain. Page 

import org.springframework.data.domain.PageRequest 

import org.springframework.data.domain.Sort 

import org.springframework.stereotype.Controller 

import org.springframework.ui.Model 

import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.RequestMethod 
import org.springframework.web.bind.annotation.RequestParam 
import org.springframework.web.bind.annotation.ResponseBody 
import org.springframework.web.servlet .ModelAndView 

import javax.servlet.http.HttpServletRequest 


@Controller 
class ImageController { 
@Autowired 
lateinit var imageRepository: ImageRepository 


@RequestMapping (value = "sotudson", method = arrayOf (RequestMethod.GET) ) 
@ResponseBody 
fun sotuJson (@RequestParam (value = "page", defaultValue ") page: Int, 
@RequestParam(value = "size", defaultValue = "10") size: Int): 
Page<Image> { 
return getPageResult (page, size) 


} 

private fun getPageResult (page: Int, size: Int): Page<Image> { 
val sort = Sort(Sort.Direction.DESC, "id") 
val pageable = PageRequest.of (page, size, sort) 
return imageRepository.findAl1l (pageable) 


} 
其 中 ; 


@Autowired 
lateinit var imageRepository: ImageRepository 


里 使 用 lateinit 关键 字 来 修饰 我 们 需要 装配 的 Bean， 表 示 imageRepository 延迟 初始 化 。 


代码 


从 上 面 的 代码 中 可 以 看 出 ，Kotlin 使 用 Spring MVC 框架 非常 自然 ， 与 使 用 原生 Java 
儿 乎 一 样 顺畅 。 但 是 有 个 较 明 显 的 区 别 是 method = arrayOf(RequestMethod.GET)， 这 


里 Kotlin 数组 声明 的 语法 是 使 用 arrayOf0, 而 在 Java 中 只 需要 使 用 括号 “{}” 括 起 来 即 可 。 
关于 注解 中 使 用 数据 的 语法 ， 在 Kotlin 1.2 版 本 中 可 以 直接 使 用 方 括号 “[]” 括 起 来 。 类 似 


Fi 


MXE: 


import org.springframework.stereotype.Controller 
import org.springframework.web-.bind.annotation.GetMapping 


@Controller 
class IndexController { 
@GetMapping(value = Inn, "/", "/index"]) //Kotlin 1.2 中 的 新 特性 : 注解 中 
的 数组 语法 
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fun index(): String { 
return "/index" 
} 
} 


重新 运行 应 用 ， 通 过 浏览 器 访问 http://127.0.0.1:8000/sotuJson?page=10&size=3, KA 
到 分 页 对 象 Page 的 ISON 字符 串 格 式 的 输出 结果 。 


3. 模糊 搜索 分 页 接口 实现 


下 面 来 实现 根据 category 字段 的 值 进行 模糊 搜索 的 接口 ,并 同时 支持 分 页 。 代 码 如 下 : 


@Query("SELECT a from #{#entityName} a where a.isDeleted=0 and a.category 
like 

%:searchText% order by a.id desc") 

fun search (@Param("searchText") searchText: String, pageable: Pageable): 
Page<Image> 


HF, @Param("searchText")searchText:String 是 搜索 关键 字 参 数 @Param 注解 指定 了 
JPQL 中 的 参数 名 searchText， 对 应 到 IPQL 中 的 参数 占 位 符 写作 :searchText， 我 们 注意 到 
这 里 模糊 查询 的 语法 是 : 


like %:searchText% 


对 应 Controller 中 的 方法 是 : 


@RequestMapping (value = "sotuSearchJson", method = arrayOf (RequestMethod.GET)) 

@ResponseBody 

fun sotuSearchJson (@RequestParam(value = "page", defaultValue = "0") page: Int, 

@RequestParam(value = "size", defaultValue = "10") size: Int, @RequestParam 

(value = 

"searchText", defaultValue = "") searchText: String): Page<Image> { 
return getPageResult (page, size, searchText) 


} 


private fun getPageResult (page: Int, size: Int, searchText: String): 
Page<Image> { 

val sort = Sort(Sort.Direction.DESC, "id") 

val pageable = PageRequest.of (page, size, sort) 


if (searchText == "") { 
return imageRepository.findAll (pageable) 
} else { 


return imageRepository.search(searchText, pageable) 
} 
j; 


这 里 需要 注意 的 是 PageRequest.of(page,size,sort)page 的 取 值 默认 是 从 0 开始 。 
新 运行 程序 ， 通 过 浏览 器 访问 http://127.0.0.1:8000/sotuSearchJson?page=10&size 
=3&searchText= 秋 天 ， 输 出 如 下 : 

{ 


"content": [ 
{ 
"id": 17443), 
"version": 0, 
"category": "初秋 岱 庙 "， 
"url": "http://img0.imgtn.bdimg.com/it/u=64076324, 3274882882&fm=27 &gp= 
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0.jpg", 
"gmtCreated": 1508924545000, 
"gmtModified": 1508924545000, 
"deletedDate": 1508924545000 
}, 
{ 
nid": 17280, 
"version": 0, 
"category": "初秋 落叶 信纸 .doc"， 
"url": "http://img5.imgtn.bdimg.com/it/u=256290403,1153099708&fm=27&gp= 
0.jpg", 
"gmtCreated": 1508924528000, 
"gmtModified": 1508924528000, 
"deletedDate": 1508924528000 
}, 
{ 
aake kt 200 
"version": 0, 
"category": "初秋 的 小 花 图 片 129k (KAA HA)", 
"url": "http://img3.imgtn.bdimg.com/it/u=1333940222, 533390017&fm=11&gp= 
0.jpg", 
"gmtCreated": 1508924510000, 
"gmtModified": 1508924510000, 
"deletedDate": 1508924510000 
} 
l, 
"pageable": { 
Nsort eeh 
"sorted": true, 
"unsorted": false 
}, 
"offset" =) 30, 
"pageSize": 3, 
"pageNumber": 10, 
"paged": true, 
"unpaged": false 
] 
"last": false, 
"totalElements": 148, 
"totalPages": 50, 
Ets She 
"number": 10, 
"numberOfElements": 3, 
Wore ia 2 
"sorted": true, 
"unsorted": false 
] 


"first": false 


13.10 ”视图 模板 开发 


后 端的 数据 接口 已 经 开发 完毕 ， 下 面 把 这 些 数据 展示 到 前 端 页 面 上 。 
我 们 使 用 的 视图 层 模板 引擎 是 Freemarker, 在 Spring Boot 中 使 用 Freemarker， 只 需要 
加 入 spring-boot-starter-freemarker 即 可 。 其 中 ， 使 用 默认 的 配置 目录 src\main\resources\ 
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templates， 模 板 文件 以 .f 为 后 级 。 
13.10.1 前 端 代码 结构 


我 们 将 前 端 依赖 的 外 部 库 静 态 资源 文件 全 部 放 到 src\main\resources\static\bower_ 
components 文件 夹 下 。 这 里 我 们 主要 使 用 的 是 jquery.js 和 bootstrap.js 文件 。 另 外 ， 后 端的 
分 页 接口 实现 前 端 分 页 的 功能 使 用 bootstrap-tablejs 库 来 实现 。 前 端 模板 文件 及 JS 源码 文 
件 的 目录 结构 如 图 13-11 所 示 。 


Y Bresources 
v Pstatic 
> Bu bower_components 
起 app.css 
im app.js 
il, search_keyword_table.js 
Se sotu_favorite_table.js 
im SOtu_table.js 
v Outemplates 
v 加 common 
á foot.ful 
起 head.ftl 
起 nav.ftl 
起 search_keyword_view.ftl 
á sotu_favorite_view.ftl 
á sotu_view.ftl 


图 13-11 前端 目录 结构 


1，head .ft 部 分 


head D) 文件 是 公共 文件 头 部 分 ， 代 码 如 下 : 


<!DOCTYPE html> 

<html> 

<head> 
<meta http-equiv=content-type content=text/html;charset=utf-8> 
<meta http-equiv=X-UA-Compatible content=IE=Edge> 
<meta charset="utf-8"> 
<meta name="viewport" content="width=device-width, initial-scale=1, 
shrink-to-fit=no"> 
<title> 搜 图 </title> 
<link href="bower components/bootstrap/dist/css/bootstrap-theme.css" 
rel="stylesheet"> 
<link href="bower components/bootstrap-table/src/bootstrap-table.css" 
rel="stylesheet"> 
<link href="bower components/bootstrap/dist/css/bootstrap.css" rel= 
"stylesheet"> 
<link href="bower components/pnotify/src/pnotify.css" rel="stylesheet"> 
<link href="app.css" rel="stylesheet"> 

</head> 

<body> 
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2. foot.ftl 部 分 


foot. fl 部 分 是 公共 页 面 的 底部 部 分 ， 代 码 如 下 : 


<script src="bower_components/jquery/dist/jquery.js"></script> 

<script src="bower components/bootstrap/dist/js/bootstrap.js"></script> 
<script src="bower_components/bootstrap-table/src/bootstrap-table.js"></script> 
<script src="bower components/bootstrap-table/src/locale/bootstrap-table-zh-CN. 
js"></script> 

<script src="bower_components/pnotify/src/pnotify.js"></sceript> 

<script src="app.js"></script> 

</body> 

</html> 


3. nav.ftl 部 分 


nav.ftl 是 导航 栏 部 分 的 代码 ， 使 用 标准 的 Bootstrap 样式 库 来 实现 : 


<nav class="navbar navbar-default" role="navigation"> 
<div class="container-fluid"> 
<div class="navbar-header"> 
<a class="navbar-brand" href="#">4# </a> 
</div> 
<div> 
<ul class="nav navbar-nav"> 


<li class='<#if requestURI=="/sotu_view">active</#if>'><a 
href="sotu_view">3 BW #</a></1i> 

<li class='<#if requestURI=="/sotu_favorite view">active 
</#if>'><a href="sotu_favorite view"> 精 选 收藏 </a> 

<li class='<#if requestURI=="/search_keyword view">active 
</#if>'><a href="search keyword view"> 搜 索 关 键 字 </a> 

</li> 


<li class=""><a href="doCrawJob" target=" blank"> 执 行 抓 取 </a></1i> 


<li class="dropdown"> 
<a href="#" class="dropdown-toggle" data-toggle="dropdown"> 
Kotlin <b class="caret"></b> 
</a> 
<ul class="dropdown-menu"> 
<li><a href="http: //www.jianshu.com/nb/12976878" target= 
"_blank">Kotlin 极 简 教程 </a></1i> 
<li><a href="http://www.jianshu.com/nb/17117730" target= 
"_blank">Kotlin 项 目 实战 开发 </a></1i> 
<li><a href="#">SpringBoot</a></1i> 
<li><a href="#">Java</a></1i> 
<li class="divider"></1i> 
<li><a href="#">Scala</a></1i> 
<li class="divider"></1i> 
<li><a href="#">Groovy</a></1i> 
</ul> 
</li> 
<li class="nav-item"> 
<a class="nav-link" href="#">K </a> 
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</li> 
</ul> 
</div> 
</div> 
</nav> 


其 中 ， 以 下 代码 是 实现 按 Tab 键 切 换 的 时 候 ，active 状态 跟随 的 交互 : 


<li class='<#if requestURI=="/sotu view">active</#if>'> 
<a href="sotu view"> 美 图 列表 </a> 

</li> 

<li class='<#if requestURI=="/sotu_favorite_view">active</#if>'> 
<a href="sotu favorite view"> 精 选 收藏 </a> 

</li> 

<li class='<#if requestURI=="/search keyword view">active</#if>'> 
<a href="search keyword view"> 搜 索 关 键 字 </a> 

</li> 


requestURI 是 后 端的 Controller 获取 当前 请 求 传 给 前 端 页 面 的 。 


@RequestMapping(value = *arrayOf("/", "sotu view"), method = arrayOf 
(RequestMethod.GET) ) 
fun sotuView(model: Model, request: HttpServletRequest) : ModelAndView { 
model.addAttribute ("requestURI", request.requestURI) 
return ModelAndView("sotu_view") 


} 
4. 图 片 列表 页 面 


新 建 sotu_view.ftl 为 图 片 列表 页 面 : 


<#include 'common/head.ftl'> 
<#include 'common/nav.ftl'> 

<table id="sotu table"></table> 
<#include 'common/foot.ftl'> 

<script src="sotu_table.js"></script> 
对 应 的 ModelAndView 控制 器 代码 如 下 : 


@RequestMapping(value = *arrayOf("/", "sotu view"), method = arrayOf 
(RequestMethod.GET) ) 
fun sotuView(model: Model, request: HttpServletRequest): ModelAndView { 
model.addAttribute ("requestURI", request.requestURI) 
return ModelAndView("sotu_view") 


13.10.2 ”实现 后 端 分 页 


我 们 使 用 表格 插件 bootstrap-tablejs 来 实现 分 页 的 前 端 样式 ， 主 要 使 用 其 中 的 
bootstrapTable 函数 来 完成 。 该 函数 定义 如 下 : 

$.fn.bootstrapTable = function (option) 

实现 分 页 的 sotu_table.js 代码 如 下 : 


$(function () { 
$.extend($.fn.bootstrapTable.defaults, $.fn.bootstrapTable.locales['zh-CN"']) 
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"188。 


var searchText = $('.search') .find('"input'") .val() 


var 


columns = [] 


columns .push ({ 


DÉI 


}, 


}) 


title: "se", 

field: 'category', 

align: 'center', 

valign: ‘middle’, 

width: '5%', 

formatter: function (value, row, index) { 
return value 

} 

{ 

title: ' 美 图 '， 

field: 'url', 

align: 'center', 

valign: 'middle', 

formatter: function (value, row, index) { 
return UU I + value +1)" 

} 

{ 

title: " WF", 

field: tida! 

align: 'center', 

width: "Dër, 

formatter: function (value, row, index) { 
var html = "" 
html += "<div onclick='addFavorite(" + value + ")' name='addFavorite' 
id="addFavorite" + value + "' class="btn btn-default'> 收 藏 </div><p>" 
html += "<div onclick='"deleteById(" + value + ")" name='delete' 
id='"delete" + value + "' class='btn btn-default'>illlR</div>" 
return html 


$('#sotu table') .bootstrapTable ({ 


url: 'sotuSearchJson', //(1) 
sidePagination: "server", 

queryParamsType: 'page,size', 

contentType: "“application/x—www-form-urlencoded", 
method: "oer", 

striped: false, // 是 否 显示 行 间隔 色 
buttonsAlign: 'right', 

smartDisplay: true, 


cache: false, // 是 否 使 用 缓存 ， 默 认为 true， 所 以 一 般 情 况 下 需要 设置 一 下 这 个 属性 (*) 


pagination: true, // 是 否 显示 分 页 (*) 
paginationLoop: true, 

paginationHAlign: 'right', //right, left 
paginationVAlign: 'bottom', //bottom, top, both 
paginationDetailHAlign: 'left', //vight, left 


paginationPreText: ' 上 一 页 '， 

paginationNextText: ' 下 一 页 '， 

search: true, 

searchText: searchText, 

searchTimeOut: 500, 

searchAlign: 'right', 

searchOnEnterKey: false, 

trimOnSearch: true, 

sortable: true, // 是 否 启用 排序 
sortOrder: "desc", // 排 序 方式 
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sortName: "id", 


pageNumber: 1, // 初 始 化 加 载 第 一 页 ， 默 认 第 一 页 
pageSize: 10, // 每 页 的 记录 行 数 (*) 
pageList: [8, 16, 32, 64, 128], // 可 选 的 每 页 数据 
totalField: 'totalElements', // (2) 所 有 记录 count 
dataField: 'content', // (3) 后 端 json 对 应 的 表格 List 数据 的 key 
columns: columns, 11 (4) 表格 每 列 的 值 
queryParams: function (params) { 
return { 


size: params.pageSize, 
page: params.pageNumber - 1, 
sortName: params.sortName, 
sortOrder: params.sortOrder, 
searchText: params.searchText 
} 
F 
classes: 'table table-responsive full-width', 
}) 
}) 


代码 说 明 如 下 : 
第 (1) 处 的 url:'sotuSearchJson' 对 应 的 后 端 查询 接口 实现 代码 是 : 
@RequestMapping (value = "sotuSearchJson"，method = arrayOf (RequestMethod.GET) ) 


@ResponseBody 
fun sotuSearchdson (@Request Param (value = "page", defaultValue = "0") page: Int, 
@RequestParam(value = "size", defaultValue = m0") size: int, 


@RequestParam(value = 
"searchText", defaultValue = "") searchText: String): Page<Image> { 
return getPageResult (page, size, searchText) 


} 


private fun getPageResult (page: Int, size: Int, searchText: String): 
Page<Image> { 

val sort = Sort(Sort.Direction.DESC, "id") 

// 注 意 : PageRequest.of (page,size,sort) page 默认 是 从 0 开始 

val pageable = PageRequest.of (page, size, sort) 


if (searchText == "") { 
return imageRepository.findAll (pageable) 
} else { 


return imageRepository.search(searchText, pageable) 
} 
} 


i 
o 


第 (2) 处 的 totalField:'totalElements' 对 应 的 是 Page 中 totalElements 属性 的 人 

第 (3) 处 的 dataField:'content' 对 应 的 是 Page 中 的 content 属性 的 值 。 

第 (4) 处 的 columns:columns 是 对 应 到 contentList 中 的 每 个 元 素 的 对 象 属性 。 例 如 这 
段 代码 : 


var columns = [] 
columns .push ({ 
titles Ri, 


field: 'category',//(1) 对 应 Image 实体 类 的 category 属性 
align: "center' 

valign: 'middle', 

width: '53', 

formatter: function (value, row, index) { //(2) 
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return value 
Ie 

GE 

代码 说 明 如 下 : 

第 (1) 处 的 field:'category' 对 应 的 就 是 Image 实体 类 的 category 属性 名 称 。 

然后 在 第 (2) 处 的 formatter:function(value,row,index) 函 数 中 处 理 该 单元 格 显示 的 
HTML 样式 。 其 中 ，value 值 对 应 该 属性 的 值 ，row 中 存储 的 是 这 一 行 对 象 的 值 ，index 是 
下 标 。 

重新 启动 程序 ， 将 看 到 分 页 及 模糊 搜索 的 效果 ， 如 图 13-12 所 示 。 


搜 图 eem won 。 搜索 关键 闻 nun kom- XF 


秋天 


aR 


ans 
OR 


显示 第 11 到 第 20 RTR, BHIN 条 记录 每 页 显示 。 10 。 条 记录 
图 13-12 分 页 及 模糊 搜索 的 效果 


其 中 , Bootstrap-table 的 完整 配置 项 在 bootstrap-tablejs 源码 (https://github.com/wenzhixin/ 
bootstrap-table) 中 的 BootstrapTable DEFAULTS 这 行 代码 中 : 


BootstrapTable.DEFAULTS = { 
classes: "table table-hover', 
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sortClass: undefined, 
locale: undefined, 
height: undefined, 
undefinedText: '-', 
sortName: undefined, 
sortOrder: ‘asc', 
sortStable: false, 
rememberOrder: false, 
striped: false, 
columns: [[]], 
data: []; 
totalField: 'total', 
dataField: 'rows', 
method: 'get', 
url: undefined, 
ajax: undefined, 
cache: true, 
contentType: 'application/json', 
dataType: 'json', 
ajaxOptions: {}, 
queryParams: function (params) { 
return params; 
}, 
queryParamsType: 'limit', //andefined 
responseHandler: function (res) { 
return res; 
}, 
pagination: false, 
onlyInfoPagination: false, 
paginationLoop: true, 
sidePagination: 'client', //client or server 
totalRows: 0, //server side need to set 
pageNumber: 1, 
pageSize: 10, 
pageList: [10, 25, 50, 100], 
paginationHAlign: ‘right’, //right, left 
paginationVAlign: 'bottom', //pottom, top, both 
paginationDetailHAlign: 'left', //right, left 
paginationPreText: "ei, 
paginationNextText: "ai, 
search: false, 
searchOnEnterKey: false, 
strictSearch: false, 
searchAlign: 'right', 
selectItemName: 'btSelectItem', 
showHeader: true, 


13.10.3 ”实现 收藏 和 删除 图 片 的 功能 


下 面 我 们 来 实现 收藏 图 片 和 删除 图 片 的 功能 。 后 端 接口 实现 代码 如 下 : 


@Modifying 

@Transactional 

@Query ("update #{#entityName} a set a.isFavorite=1,a.gmtModified=now () 
where a.id=:id") 

fun addFavorite (@Param("id") id: Long) 


us 
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@Modifying 

@Transactional 

@Query ("update #{#entityName} a set a.isDeleted=1 where a.id=:id") 
fun delete (@Param("id") id: Long) 


我 们 用 isFavorite=1 表示 该 图 片 是 被 收藏 的 , isDeleted=1 表示 该 图 片 被 删除 。 需 要 注意 的 
是 JPA 中 update, delete 操作 需要 在 对 应 的 函数 上 添加 @Modifying 和 @Transactional 
注解 。 

控制 层 的 HTTP 接口 代码 如 下 : 


@RequestMapping (value = "addFavorite", method = arrayOf (RequestMethod. POST) ) 
@ResponseBody 
fun addFavorite (@RequestParam(value = "id") id: Long): Boolean { 
imageRepository.addFavorite (id) 
return true 


} 


@RequestMapping (value = "delete", method = arrayOf (RequestMethod. POST) ) 
@ResponseBody 
fun delete (@RequestParam(value = "id") id: Long): Boolean { 
imageRepository.delete (id) 
return true 


} 
前 端 JS 代码 如 下 : 


function addFavorite(id) { 
$.ajax({ 
url: 'addFavorite', 
data: {id: id}, 
dataType: 'json', 
type: 'post', 
success: function (resp) { 
//alert (JSON. stringify (resp) ) 
new PNotify({ 
title: ' 收 藏 操作 '， 
styling: 'bootstrap3', 
text: JSON.stringify(resp), 
type: "success', 
delay: 500, 
DÉI 
}, 
error: function (msg) { 
//alert (JSON. stringify (msg) ) 
new PNotify({ 
title: "收藏 操作 ' 
styling: 'bootstrap3', 
text: JSON.stringify (msg), 
type: ‘error', 
delay: 500, 
H; 


} 
function deleteById(id) { 
$.ajax({ 


url: '"delete', 
data: {id: id}, 
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ji 


dataType: 'json', 
type: 'post', 
success: function (resp) { 
//alert (JSON.stringify (resp) ) 
$('#sotu favorite table') .bootstrapTable('refresh') 
$("'#sotu_table') .bootstrapTable('refresh') 
new PNotify({ 
title: "删除 操作 ， 
styling: 'bootstrap3', 
text: JSON.stringify(resp), 
type: "infor, 
delay: 500, 
DÉI 
}, 
error: function (msg) { 
//alert (JSON. stringify (msg) ) 
new PNotify({ 
title: "删除 操作 ' ， 
styling: 'bootstrap3', 
text: JSON.stringify (msg), 
type: ‘error', 
delay: 500, 
Jus 


对 应 表格 中 的 前 端 按 钮 组 件 代 码 在 sotu_tablejs 中 ， 关 键 代 码 片段 如 下 : 


{ 


} 


title: ! ME 

field: 'id', 

align: 'center', 

width: '5%', 

formatter: function (value, row, index) { 
var html = mn 
html += "<div onclick='addFavorite (" + value + ")' name= 'addFavorite' 
id='addFavorite" + value + "' class='btn btn-default'> 收 藏 </div><p>" 
html += "<div onclick='deleteById(" + value + ")' name='delete' 
id='delete" + value + "' class='btn btn-default' >illR</div>" 
return html 


然后 在 sotu tablejs 中 ， 实 现 单 击 图 片 自动 触发 下 载 图 片 到 本 地 的 功能 。 代 码 如 下 : 


i 


title: '%H', 

field: "url", 

align: 'center', 

valign: 'middle', 

formatter: function (value, row, index) { 
return SUII + value + TJA 


} 


Heth, downloadImage() A BIS MF: 


function downloadImage(src) { 
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var $a = $("<a></a>") .attr("href"，src) .attr("download"，"sotu.png") 7 
$a[0] .click(); 


13.104 搜索 关键 字 管 理 


本 节 我 们 开发 管理 怜 虫 疏 取 的 关键 字 的 功能 。 
1. 数据 库 实体 类 
首先 ， 新 建 实体 类 SearchKeyWord 如 下 : 


package com.easy.kotlin.picturecrawler.entity 


import java.util.* 
import javax.persistence.* 


@Entity 
@Table (indexes = arrayOf (Index (name = "idx key word", columnList = "keyWord", 
unique = true) ) ) 
class SearchKeyWord { 
@Id 
@GeneratedValue (strategy = GenerationType. IDENTITY) 
var id: Long = -1 
@Column (name = "keyWord", length = 50, nullable = false, unique = true) 
var keyWord: String = "" 
@Column (nullable = true) 
var totalImage: Int? = 0 
var gmtCreated: Date = Date() 
var gmtModified: Date = Date() 
var isDeleted: Int = 0 //1 Yes, 0 No 
var deletedDate: Date = Date() 


ji 
其 中 ，keyWord 是 搜索 关键 字 ， 有 唯一 性 约束 ， 同 时 我 们 给 它 建立 了 索引 。 
2. dao 层 接口 


接着 来 实现 插入 数据 的 dao 层 接口 。 


@Modifying 
@Transactional 
@Query (value = "INSERT INTO 'search key word' ("deleted date', 'gmt created', 
"gmt modified', 'is deleted', "key word’) VALUES (now(), now(), now(), 
'0', :keyWord) ON 

DUPLICATE KEY UPDATE 'gmt_modified' = now()", nativeQuery = true) 
fun saveOnNoDuplicateKey (@Param ("keyWord") keyWord: String): Int 


HP, ON DUPLICATE KEY UPDATE 这 名 代码 表示 当 遇 到 重复 的 键 值 时 ， 执 行 更 新 
gmt_modified=now() 的 操作 。 这 里 nativeQuery=true， 表 示 使 用 的 是 原生 SQL 查询 。 


3. 系统 启动 初始 化 动作 


我 们 在 应 用 启动 类 PictureCrawlerApplication 中 添加 初始 化 动作 : 
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package com.easy.kotlin.picturecrawler 


import com.easy.kotlin.picturecrawler.dao.SearchKeyWordRepository 
import com.easy.kotlin.picturecrawler.entity.SearchKeyWord 

import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.boot .CommandLineRunner 

import org.springframework.boot.SpringApplication 

import org.springframework.boot .autoconfigure.SpringBootApplication 
import org.springframework.core.Ordered 

import org.springframework.core.annotation.Order 

import org.springframework.scheduling.annotation.EnableScheduling 
import org.springframework.stereotype.Component 

import java.io.File 


@SpringBootApplication 
@EnableScheduling 
class PictureCrawlerApplication 


fun main(args: Array<String>) { 
SpringApplication.run(PictureCrawlerApplication::class.java, *args) 


} 


@Component 
@Order (value = Ordered.LOWEST PRECEDENCE) 
class initSearchKeyWordRunner : CommandLineRunner { 
@Autowired lateinit var searchKeyWordRepository: SearchKeyWordRepository 


override fun run(vararg args: String) { 


var keyWords = File(" 搜 索 关 键 词 列表 .data") .readLines () 
keyWords.forEach { 
val SearchKeyWord = SearchKeyWord () 
SearchKeyWord.keyWord = it 
searchKeyWordRepository.saveOnNoDuplicateKey (it) 


} 

Spring Boot 应 用 程序 在 启动 后 会 去 遍历 CommandLineRunner 接口 的 实例 并 运行 它们 
的 run 方法 。 使 用 @Order 注解 来 指定 CommandLineRunner 实例 的 运行 顺序 。 

4. 搜索 查询 接口 

查询 所 有 关键 字 记录 接口 如 下 : 


@Query ("SELECT a from #{#entityName} a where a.isDeleted=0 order by a.id desc") 
override fun findAll(pageable: Pageable): Page<SearchKeyWord> 


模糊 搜索 关键 字 接口 如 下 : 


@Query ("SELECT a from #{#entityName} a where a.isDeleted=0 and a.keyWord like 
%:searchText% order by a.id desc") 

fun search (@Param("searchText") searchText: String, pageable: Pageable): 
Page<SearchKeyWord> 


5. 模糊 搜索 HTTP 接 口 的 实现 


与 搜索 图 片 分 类 的 逻辑 类 似 ， 模 糊 搜 索 关 键 字 的 接口 如 下 : 


Sie 
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@RequestMapping (value = "searchKeyWordJson", method = arrayOf (Request- 

Method.GET) ) 

@ResponseBody 

fun sotuSearchJson (@RequestParam(value = "page", defaultValue = "0") 
page: Int, @RequestParam(value "size", defaultValue = "10") size: Int, 
@Request Param (value = "searchText", defaultValue ="") searchText: String): 
Page<SearchKeyWord> { 

return getPageResult (page, size, searchText) 


} 


private fun getPageResult (page: Int, size: Int, searchText: String): 
Page<SearchKeyWord> { 
val sort = Sort(Sort.Direction.DESC, "id") 
// 注 意 : PageRequest .of (page, size, sort) page 默认 是 从 0 开始 
val pageable = PageRequest.of (page, size, sort) 


if (searchText == "") { 
return searchKeyWordRepository.findAl1 (pageable) 
} else { 


return searchKeyWordRepository.search(searchText, pageable) 
} 
} 


6. 前端 列 表 页 面 代码 


search_keyword_view.ftl 模板 页 面 代 码 如 下 


<#include 'common/head.ftl'> 
<#include 'common/nav.ftl'> 
<form id="add_key word form"> 
<div class="col-lg-3"> 
<div class="input-group"> 
<input name="keyWord" 
id="add_key word form_keyWord" 
type="text" 
class="form-control" 
placeholder="4ij A IG 24M KES "> 
<span class="input-group-btn"> 
<button id="add_key word form save button" 
class="btn btn-default" 
type="button"> 
保存 
</button> 
</span> 
</div><!-- /input-group --> 
</div><!-- /.col-lg-3 --> 
</form> 
<table id="search keyword _table"></table> 
<#include 'common/foot.ftl'> 
<script src="search_keyword table.js"></script> 


search keyword tablejs 代码 如 下 : 


$(function () { 
$ .extend ($.fn.bootstrapTable.defaults, $.fn.bootstrapTable.locales['zh-CN"] 
var searchText = $('.search') .find("input") .val() 


var columns = [] 


columns .push ( 
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ticle: "IDU 

field: "id", 

align: 'center', 

valign: 'middle', 

width: '10%', 

formatter: function (value, row, index) { 
return value 


} 


title: ' 关 键 字 '， 

field: 'keyWord', 

align: 'center', 

valign: 'middle', 

formatter: function (value, row, index) { 


var html = "<a href='sotu_view?keyWord=" + value + "' target= 


" blank'>" + value + "</a>" 
return html 


title: "图 片 总 数 "， 

field: 'totalImage', 

align: 'center', 

valign: 'middle', 

formatter: function (value, row, index) { 


var html = "<a href='sotu_view?keyWord=" + row.keyWord + "' 


target=' blank'>" + row.totalImage + "</a>" 
return html 


}) 


$('#search keyword table') .bootstrapTable ({ 
url: 'searchKeyWordJson', 
sidePagination: "server", 
queryParamsType: 'page,size', 
contentType: "application/x-www-form-urlencoded", 
method: 'get', 


striped: false, // 是 否 显示 行 间隔 色 


cache: false, // 是 否 使 用 缓存 ， 默 认为 true， 所 以 一 般 情况 下 需要 设置 一 下 这 个 属性 (*) 


pagination: true, // 是 否 显示 分 页 (*) 
paginationLoop: true, 


paginationHAlign: ‘right’, //right, left 
paginationVAlign: 'bottom', //bottom, top, both 
paginationDetailHAlign: 'left', //right, left 


paginationPreText: ' 上 一 页 "， 
paginationNextText: ' 下 一 页 '， 
search: true, 

searchText: searchText, 
searchTimeOut: 500, 
searchAlign: 'right', 
searchOnEnterKey: false, 
trimOnSearch: true, 


sortable: true, // 是 否 启用 排序 

sortOrder: "desc", // 排 序 方 式 

sortName: "id", 

pageNumber: 1, // 初 始 化 加 载 第 一 页 ， 默 认 第 一 
pageSize: 10, // 每 页 的 记录 行 数 (*) 
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pageList: [8，16，32，64，128] ，// 可 选 的 每 页 数据 
totalField: 'totalElements', // 所 有 记录 count 
dataField: 'content', // 后 端 json 对 应 的 表格 List 数据 的 key 
columns: columns, 
queryParams: function (params) { 
return { 
size: params.pageSize, 
page: params.pageNumber - 1, 
sortName: params.sortName, 
sortOrder: params.sortOrder, 
searchText: params.searchText 
} 
DÉI 
classes: "table table-responsive full-width', 
}) 
}) 


7. 添加 的 取 关 键 字 
BIERKE HTTP 接口 代码 如 下 


@RequestMapping (value = "save keyword", method = arrayOf (RequestMethod.GET, 
RequestMethod. POST) ) 

@ResponseBody 

fun save (@RequestParam(value = "keyWord")keyWord:String): String { 


Jelse{ 
searchKeyWordRepository.saveOnNoDuplicateKey (keyWord) 
return "1" 


2 
前 端 输入 框 表 单 代 码 如 下 : 


<form id="add key_word_form"> 
<div class="col-lg-3"> 
<div class="input-group"> 
<input name="keyWord" 
id="add_key word form_keyWord" 
type="text" 
class="form-control" 
placeholder=" HAME EMRK EF "> 
<span class="input-group-btn"> 
<button id="add key word form save_button" 
class="btn btn-default" 
type="button"> 
保存 
</button> 


</span> 
</div><!-- /input-group --> 
</div><!-- /.col-lg-3 --> 
</form> 


对 应 的 IS 代码 如 下 : 


$('#add key word form save button').on('click', function () { 
var keyWord = $('#add_key word form keyWord') .val() 
$.ajax({ 
url: 'save_keyword', 
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type: "get', 
data: {keyWord: keyWord}, 
success: function (response) { 


if (response == "1") { 

alert ("保存 成 功 ") 

Sam #search_ keyword table') -bootstrapTable('refresh') 
} else { 

alert ("数据 不 能 为 空 ") 


}, 
error: function (error) { 
alert (JSON.stringify (error) ) 
} 
}) 
}) 


teH, $('#search keyword_ table).bootstrapTable(refresh) 是 保存 成 功 后 ， 刷 新 表格 后 的 
8. 更 新 该 关键 字 的 图 片 总 数 
下 面 来 实现 统计 一 个 关键 字 对 应 的 图 片 总 数列 表 的 功能 ， 效 果 如 图 13-13 所 示 。 
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图 13-13 ”搜索 关键 字 对 应 的 图 片 总 数列 表 


更 新 search_ key word 表 total image 字段 的 SQL 逻辑 代码 如 下 : 


@Modifying 

@Transactional 

@Query ("update search_key word a set a.total_image = (select count (zl from 
image i where i.is_deleted=0 and i.category like concat ('%',a.key word,'%'))", 
nativeQuery = true) 

fun batchUpdateTotalImage () 


表示 该 对 应 关键 字 所 包含 的 图 片 总 数 。 然 后 开始 执行 这 个 定时 任务 ， 代 码 如 下 : 
package com.easy.kotlin.picturecrawler. job 


import com.easy.kotlin.picturecrawler.dao.SearchKeyWordRepository 
import kotlinx.coroutines.experimental.CommonPool 
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import kotlinx.coroutines.experimental. launch 

import kotlinx.coroutines.experimental.runBlocking 

import org.springframework.beans.factory.annotation.Autowired 
import org.springframework.scheduling.annotation.Scheduled 
import org.springframework.stereotype.Component 

import java-util.* 


@Component 
class BatchUpdateJob { 


@Autowired lateinit var searchKeyWordRepository: SearchKeyWordRepository 


@Scheduled(cron = "0 */5 * * * an 

fun job() { 
println ("开始 执行 定时 任务 batchUpdateTotalImage: ${Date()}") 
searchKeyWordRepository.batchUpdateTotalImage () 


13.10.5 {fA MERA Me BES 


上 面 我 们 的 定时 任务 都 是 同步 的 。 当 我 们 想 用 HTTP 接口 去 触发 任务 执行 的 时 候 ， 可 
能 并 不 想 一 直 等 待 ， 这 个 时 候 可 以 使 用 异步 的 方式 。 这 里 我 们 使 用 Kotlin 提供 的 轻 量 级 线 
程 一 一 协 程 来 实现 。 在 常用 的 并 发 模型 中 ， 多 进程 、 多 线程 、 分 布 式 是 最 普遍 的 ， 不 过 近 
些 年 来 逐渐 有 一 些 语言 以 first-class 或 者 library 的 形式 提供 对 基于 协 程 并 发 模型 的 支持 。 
其 中 比较 典型 的 有 Scheme、Lua、Python、Perl、Go 等 以 first-class 方式 提供 对 协 程 的 支持 。 
同样 ，Kotlin 也 支持 协 程 。( 关 于 协 程 的 更 多 介绍 ， 可 参考 《Kotlin 极 简 教 程 》 第 9 章 轻 
量 级 线程 : 协 程 ) 

在 build.gradle 中 添加 kotlinx-coroutines-core 依赖 : 


compile group: 'org.jetbrains.kotlinx', name: 'kotlinx-coroutines-core', 
version: '0.19.2' 


然后 把 定时 任务 代码 修改 如 下 : 


@Component 
class BatchUpdateJob { 


@Autowired lateinit var searchKeyWordRepository: SearchKeyWordRepository 


@Scheduled(cron = "0 */5 * * * ?") 
fun job() { 

doBatchUpdate () 
} 


fun doBatchUpdate() { 
launch(CommonPool) { 


println ("开始 执行 定时 任务 batchUpdateTotalImage: ${Date()}") 
searchKeyWordRepository.batchUpdateTotal Image () 


` 
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fun doCrawJob() { 
val list = searchKeyWordRepository.findAll() 
for (3 am 1-1000) at 
list.forEach { 
launch (CommonPool) { 
saveImage (it.keyWord, i) 


} 


} 

WF, launchQ eA Zi Z— E3 (non-blocking) 当前 线程 的 方式 ， 启 动 一 个 新 的 协 程 
后 台 任 务 ， 并 返回 一 个 Job 类 型 的 对 象 作为 当前 协 程 的 引用 。 我 们 把 真正 要 执行 的 代码 逻 
和 辑 放 到 launch(CommonPool){ //... } 中 ， 这 样 就 可 以 手动 启动 任务 进行 异步 执行 了 。 


13.10.6 图 片 存 入 数据 库 并 在 前 端 展现 


数据 库 实体 类 如 下 : 
package com.easy.kotlin.picturecrawler.entity 


import java.util.* 
import javax.persistence.* 


@Entity 
@Table (indexes = arrayOf ( 
Index (name = "idx url", unique = true, columnList = "url"), 
Index (name = "idx category", unique = false, columnList = "category") )) 
class Image { 
@Id 


@GeneratedValue (strategy = GenerationType. IDENTITY) 
var id: Long = -1 

@Version 

var version: Int = 0 


@Column (length = 255, unique = true, nullable = false) 
var category: String = "" 

var isFavorite: Int = 0 

@Column (length = 255, unique = true, nullable = false) 


var url: String = "" 


var gmtCreated: Date = Date() 

var gmtModified: Date = Date() 

var isDeleted: Int = 0 //1 Yes, 0 No 
var deletedDate: Date = Date() 


@Lob 

var imageBlob: ByteArray = byteArrayOf () 
/* 0-Baidu 1-Gank */ 

var sourceType: Int = 0 


override fun toString(): String { 
return "Image (id=$id, version=$version, category="Scategory', isFavorite= 
S$isFavorite, url='$url', gmtCreated=$gmtCreated, gmtModified= 
$gmtModified, isDeleted=$isDeleted, deletedDate=$deletedDate) " 
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其 中 ，@Lob var imageBlob: ByteArray =byteArrayOfO 这 个 字段 存储 图 片 的 Base64 
容 。 当 然 ， 我 们 在 生产 环境 中 通常 不 会 这 样 存储 图 片 等 文件 ， 而 是 单独 放 在 文件 服务 器 | 


内 


TT 


我 们 在 数据 库 里 只 存 图 片 ul 即 可 。 这 里 为 了 方便 演示 ， 就 直接 存 进 数据 库 里 了 。 把 图 
比特 流 数组 存 入 数据 库 代 码 如 下 : 

val image = Image() 

image.category = "干货 集中 营 福利 " 

image.url = url 

image.sourceType = 1 

image.imageBlob = getByteArray (url) 

logger.info("Image = ${Image}") 

imageRepository.save (Image) 


其 中 的 getByteArray(url) 函数 代码 如 下 : 


Private fun getByteArray(url: String): ByteArray { 
val urlobj = URL(url) 
return urlObj.readBytes () 

} 


前 端 HTML 展示 图 片 的 代码 如 下 : 
{ 


title: 'HF', 

field: 'imageBlob', 

align: 'center', 

valign: 'middle', 

formatter: function (value, row, index) { 


片 


//var html = "<img onclick=downloadImage('" + value + "') 
width='100%' src='" + value + "'>" 
var html = '<img onclick="downBase64Image(this.src)" width= 


"100%" src="data:image/jpg;base64,' + value + '"/>' 
return html 


- 


单 击 下 载 的 IS 代码 如 下 : 


function downloadImage(src) { 
var $a = $("<a></a>") .attr("href", src) .attr("download", "sotu.png" 
$a[0].click(); 


} 


function downBase64Image (url) { 
var blob = base64Img2Blob (url) ; 
url = window.URL.createObjectURL (blob) ; 
var $a = $("<a></a>") .attr ("href", url) .attr("download", "sotu.png" 
$a[0].click(); 
D 


function base64Img2Blob(code) { 
var parts = code.split(';base64,"); 
var contentType = parts[0].split('":") [1]; 
var raw = window.atob(parts[1]); 
var rawLength = raw.length; 
var ulnt8Array = new Uint8Array(rawLength) ; 


for (var i = 0; i < rawLength; ++i) { 
ulInt8Array[i] = raw.charCodeAt (i); 


WI 
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} 


return new Blob([ulInt8Array], {type: contentType}) ; 
} 


本 节 完 整 的 项 目 源码 地 址 是 https://github.com/EasySpringBoot/picture-crawler 
se 
13.11 RE # 


在 Spring Framework 5.0 中 已 经 添加 了 对 Kotlin 的 支持 。 使 用 Kotlin 集成 Spring Boot 
开发 非常 流畅 自然 ， 儿 乎 不 需要 任何 迁移 成 本 。 所 以 ，Kotlin 在 未 来 的 Java 服务 端 领域 也 
必 将 受到 越 来 越 多 的 程序 员 的 关注 。 
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本 章 将 带领 大 家 快速 入 门 如 何 使 用 Kotlin 进行 Android 应 用 程序 的 开发 。 

在 Realm Report(2017-Q4，https://realm.io/realm-report/2017-q4) 中 ， 在 2016 年 9 月 至 
2017 年 9 H Android 端的 开发 : Java 从 95% 降 低 到 了 85%， 而 Kotlin 从 5% 涨 到 了 15%, 
如 图 14-1 所 示 。 


Kotlin is about to changethe whole Android ecosystem 


Leva BR Kotin 


Percent of developers 
p383 88883888 


图 14-1 Kotlin 在 Android 领域 2016 4F 9 月 至 2017 4F 9 月 的 占 比 情况 


Kotlin 在 Android 领域 2018 年 的 占 比 预测 如 图 14-2 所 示 。 


Percent of developers 
S8883s8s88 


图 14-2 Kotlin 在 Android 领域 2018 年 的 占 比 预测 
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从 这 个 趋势 来 看 ， 加 上 最 新 Android Studio 3.0 的 发 布 〈 内 置 Kotlin 开发 Android 项 目 
的 支持 ) ，Kotlin 将 会 很 快 颠覆 Java 在 Android 领域 的 地 位 。 


14.1 快速 开发 Hello World 


本 节 我 们 从 一 个 简单 的 Kotlin 版 本 的 Hello World Android 应 用 程序 开始 。 
14.11 准备 工作 


首先 准备 好 开发 工具 。Android 开发 还 是 建议 用 Google 官方 支持 的 IDE: Android 
Studio. 


1. Android Studio 3.0 简介 


Google d 2017 4 10 H 26 日 发 布 了 Android 8.1 首 个 开发 者 预览 版 的 同时 还 正式 发 布 
了 Android Studio 3.0， 为 其 IDE 引入 了 一 系列 新 功能 。 

Android Studio 3.0 专注 于 加 速 Android 应 用 开发 ， 包 含 大 量 更 新 内 容 ， 其 中 最 主要 的 
功能 之 一 就 包括 对 Kotlin 的 支持 。 正 如 Google 在 2017 年 的 VO 开发 者 大 会 上 所 宣布 的 那 
样 ，Kotlin 已 被 官方 支持 用 于 Android 开发 。Android Studio 3.0 是 第 一 个 支持 Kotlin 语言 
的 里 程 碑 式 版 本 〈 在 此 之 前 ， 可 以 使 用 Android Studio 的 Kotlin 插件 ) 。 

在 Android Studio 3.0 中 提供 了 许多 方便 且 实 用 的 功能 ,如 代码 自动 补 全 和 语法 高 亮 显 
示 。 另 外 ，Android Studio 内 置 转换 工具 可 以 非常 方便 地 把 Java 代码 转换 成 Kotlin 代码 ， 
如 图 14-3 所 示 。 


1 package com.easy.kotlin.myjavahelloworld. feature; 
2 
3 import android. support.v7.app.AppCompatActivity; 
4 import android.os. Bundle; 
5 
6 @ public class MainActivity extends AppCompatActivity { 
7 
8 @O0verride 
9 el protected void onCreate(Bundle savedInstanceState) { 
10 super.onCreate(savedInstanceState) ; 
Va setContentView(R. layout.activity_main); 
12 H 
13 } 
14 
15 
16 


图 14-3 ”打开 要 转换 的 Java 代码 源 文件 


首先 ， 打 开 要 转换 的 Java 代码 源 文件 MainActivityjava， 如 图 14-3 所 示 。 
然后 在 菜单 栏 中 依次 选择 Code | Convert Java File to Kotlin File 命令 ， 如 图 14-4 所 示 。 
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Analyze Refactor Build Run Tools VCS Window Help Bz 


| Override Methods... -0 ~ [-/kotlin/MyJavaHelloWorid] 
Implement Methods... ^l 
Delegate Methods... 
Generate... gen world. feature; 
Surround With... Car PmPatActivity; 
Unwrap/Remove... ORD 
Completion z AppCompatActivity { 
Folding >| 
| savedInstanceState) { 
d Insert Live Template... SI testate); 
“| Surround with Live Template... 51 Hvity-main); 
Comment with Line Comment EI 
Comment with Block Comment "SI 
Reformat Code XSL 
Show Reformat File Dialog XOSL 
Auto-Indent Lines axi 
Optimize Imports axo 
Rearrange Code 
Move Statement Down ONL 
ORT 
Move Line Down XO! 
Move Line Up xot 


Convert Java File to Kotlin File X Q&3K 


图 14-4 依次 选择 Code | Convert Java File to Kotlin File 命令 


选择 上 面 的 命令 后 ， 将 看 到 转换 之 后 的 Kotlin 代码 MainActivity.kt， 如 图 14-5 所 示 。 


@ activity mainxmi 二 MainActivity.kt 


1 package com. easy. kotlin.myjavahelloworld. feature 
2 
3 import android. support.v7.app.AppCompatActivity 
4 import android.os.Bundle 
5 
6 @ class MainActivity : AppCompatActivity() { 
7 
| 8 of override fun onCreate(savedInstanceState: Bundle?) { 
9 super. onCreate(savedInstanceState) 
| 10 setContentView(R. layout. activity main) 
11 + 
{12 H 


图 14-5 ”转换 之 后 的 Kotlin 代码 
2. 安装 Android Studio 3.0 
Android Studio 是 Android 的 官方 IDE.Android Studio 3.0 的 一 个 亮点 就 是 内 置 了 Kotlin 


的 支持 ， 可 参看 Google 官方 介绍 : https://developer.android.google.cn/kotlin/index.html。 
在 Google 2017 年 的 IO 开发 者 大 会 上 ，Kotlin 已 成 为 Google 钦定 的 Android 官方 开 
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使 用 Android Studio 3.0， 可 以 方便 地 把 Java 源 代码 自动 转换 成 Kotlin 代码 ， 也 可 以 直 
接 创 建 Kotlin 语 言 开 发 的 Android 项 目 , 只 需要 在 新 建 项 目的 时 候 勾 选 Include Kotlin support 
即 可 。 

首先 去 官网 https://developer.android.google.cn/studio/install.html 下 载 安 装 包 。 笔者 当前 
下 载 的 安装 包 版 本 是 android-studio-ide-171.4408382-mac.dmg, 下 载 完毕 后 单 击 dmg 文件 ， 
如 图 14-6 所 示 。 


ece k= Android Studio 30 
x EMR 1 MRE (R2 M) 一 一 一 


A™ Android 
FX Studio 


4 uch Studo 30 » ® Android Studio 


图 14-6 下载 完 毕 单 击 dmg 文件 
然后 将 其 复制 到 应 用 程序 中 即 可 。 
14.1.2 ”创建 基于 Kotlin 的 Android 项 目 


首先 新 建 项 目 。 如果 尚未 打开 项 目 , 请 在 Welcome to Android Studio 窗口 中 选择 Start a 
new Android Studio project 选项 ， 如 图 14-7 所 示 。 


e Welcome to Android St 


GankClient-Kotlin 
=— 
| Android Studio 


a Start a new Android Studio project 

5 Open an existing Android Studio project 
$ Check out project from Version Control ~ 
[E Profile or debug APK 

uf import project (Gradle, Eclipse ADT, etc.) 
if Import an Android code sample 


% Configure - Get Help ~ 


图 14-7 选择 Start a new Android Studio project 选项 
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如 果 已 经 打开 项 目 ， 依 次 选择 File | New | New Project 命令 ， 如 图 14-8 所 示 。 


Close Project 
Link C++ Project with Gradle 


Other Settings D 


Import Settings... 
Export Settings... 


t Project Structure.. s8; | 


@ Android Studio D Edit View Navigate Code Analyze Refactor Build Run Tools VCS Window Help 


Import Project... 
Project from Version Control 


Open Recent D 


© Java Class 

Ñ Kotiin File/Class 

Š Android resource file 

fm Android resource directory 


D 


inAppica 


Mainacov yt 


De 


smykot LinappLication 


47. app. AppConpatActivity 


dompartctivity() { 


te(savedtnstanceState: Bundle?) { 
savedInstanceState) 
R. layout. activity main) 


Export to Zip File.. Ba Sample Data directory 
‘Settings Repository... S File 
D Di xs Š Scratch File ON 
Da Pacha 
© Synchronize TY 
invalidate Caches | Restart... E C++ Class 
SE Š cic» Source Fle 
e Print... A C/C++ Header File 
Add to Favorites » D 
“mage Asset 
File Encoding Pine 
Line Separators > = 
Make File Read-only Š Singleton 
Power Save Mode | Edit File Templates... 
a strings = 
ADL > 
Y @Gradle Scripts * Activity > 
(È build. gradie (Project: MyKotlinApplication) ® Android Auto D 
@ buid.gradle (Module: app) ‘i Folder D 
gradie-wrapper.properties (Gradio Version Š Fragment > 
proguard-rules.pro Proguard Rules for appi A EAR S 
i if oredle.properties (Project Properties) other x 
J S seings.grodie (Project Seen Beene = 
3 local. properties (SDK Location ees S 
D  Woar > 
党 Widget > 
XML > 
fi Resource Bundle 
图 14-8 选择 File | New | New Project 命令 


此 时 弹出 Create Android Project 对 话 框 。 在 创建 Android 项 目 对 话 框 中 配置 应 用 基本 


言 息 ， 注 意 勾 选 Kotlin 支持 选项 ， 


-208 = 


xx Create Android Project 


Applicationname 


MyKotlinApplication 


Company domain 


{kotlin.easy.com 


Project location 


Create New Project 


单 击 Next 按钮 ， 如 图 14-9 所 示 。 


[/Users/jack/kotlin/MyKotlinApplication| 


Package name 


com.easy.kotlin.mykotlinapplication 


了 Include C++ support 
Include Kotlin support 


图 14-9 创建 Android 项 目 


Cancel 


Previous 


Edit 


Finish 
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此 时 进入 Create Android Project 界面 , 在 其 中 配置 应 用 运行 SDK 及 环境 信息 , 如 图 14-10 
所 示 。 


KE? Create New Project 


yx Target Android Devices 


Select the form factors and minimum SDK 
Some devices require additional SDKs. Low API levels target more devices, but offer fewer API features. 


Phone and Tablet 

API 15: Android 4.0.3 (iceCreamSandwich) B 

By targeting AP115 and later, your app will run on approximately 100% of devices. Help me choose 
了] Include Android Instant App support 

Wear 

API 21: Android 5.0 (Lollipop) B 
TV 

API 21: Android 5.0 (Lollipop) B 
Android Auto 
Android Things 

API 24: Android 7.0 (Nougat) B 


Cancel | | Previous | EE | Finisn 
图 14-10 配置 应 用 运行 SDK 及 环境 信息 


然后 勾 选 Phone and Tablet 复 选 框 ， 然 后 选择 API 15: Android 4.0.3， 单 击 Next 按钮 
进入 添加 Activity 界面 ， 如 图 14-11 所 示 。 


a Bok) Create New Project 


Kë Add an Activity to Mobile 


Add No Activity 


Basic Activity Bottom Navigation Activity 


< SS 
9 


Cance! | | Previous | EEN Fris 


图 14-11 添加 Activity 界面 


“Ds 


Kotlin 从 入 门 到 进 阶 实 战 


这 里 选择 Empty Activity， 然 后 单 击 Next 按钮 进入 配置 Activity 界面 ， 如 图 14-12 
所 示 。 


H 8 Create New Project 


Creates a new empty activity 


MainActivity 


Generate Layout File 


Layout Name 


activity_main 


Backwards Compatibility (AppCompat) 


Cancel Previous Net | Foish 
图 14-12 配置 Activity 界面 


配置 好 Activity Name 与 Layout Name 之 后 ， 单 击 Finish 按钮 。 之 后 我 们 将 得 到 一 个 
Kotlin 版 本 的 Hello World 的 Android 应 用 程序 。 工 程 目录 如 图 14-13 所 示 。 


14.13 ”工程 目录 文件 说 明 


其 中 ， 在 顶层 的 Grade 配置 文件 build.gradle 中 添加 了 kotlin-gradle-plugin 插件 的 
依赖 : 


buildscript { 
ext.kotlin version = '1.1.51' 


dependencies { 
classpath 'com.android.tools.build:gradle:3.0.0' 
classpath "org. jetbrains.kotlin:kotlin-gradle-plugin:$kotlin version" 
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v BMyApplication ~/kotlin/MyApplication 
> Ba .gradle 
> "RI 
Y mapp 
> Ba build 
Mm libs 
v erc 
> MandroidTest 
了 Pn main 
了 Mjava 
Y Bacom.easy.kotlin.myapplication 
@ > MainActivity 
> Pre 
Eà AndroidManifest.xml 
v Mtest 
v java 
了 Ba com.easy.kotlin.myapplication 
G > ExampleUnitTest 
@ .gitignore 
Bz app.iml 
(5 build.gradle 
@ proguard-rules.pro 
> Bubuild 
> Mgradle 
2 .gitignore 
(Ò build.gradle 
i gradle.properties 
2 gradlew 
SS gradlew.bat 
i local.properties 
B MyApplication.iml 


L a Dro eam andraid eunnart tact-rilac 1 N 1 


(5 settings.gradle 
|i External Libraries 
> e Android API 26 Platform > /Users/jack/Library/Android/sdk 
> Ba < JDK > /Applications/Android Studio.app/Contents/jre/jdk/Contents/H) 
> Byandroid.arch.core:common:1.0.0@jar 
> Wyandroid.arch.lifecycle:common:1.0.0@jar 
> WByandroid.arch.|lifecycle:runtime-1.0.0 
» lj, com.android.support.constraint:constraint-layout-1.0.2 
> [yj,com.android.support.constraint:constraint-layout-solver:1.0.2@jar 
> [fj,com.android.support.test.espresso:espresso-core-3.0.1 
> [j,com.android.support.test.espresso:espresso-idling-resource-3.0.1 


图 14-13 工程 目录 


app 目录 下 的 build.gradle 配置 文件 内 容 如 下 : 
apply plugin: 'com.android.application'" 
apply plugin: 'kotlin-android' 

apply plugin: 'kotlin-android-extensions' 


dependencies { 


ss 
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implementation"org. jetbrains.kotlin:kotlin-stdlib—jre7:$kotlin version" 


} 


其 中 的 apply plugin:'kotlin-android-extensions'#z 4 {#' /{] Kotlin Android Extensions 插件 。 
这 个 插件 是 Kotlin 专门 针对 Android 扩展 的 插件 ， 实 现 了 与 Data-Binding, Dagger 等 框架 
的 功能 。 

布局 文件 activity_main.xml 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<android.support.constraint.ConstraintLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
xmlns:tools="http://schemas.android.com/tools" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
tools:context="com.easy.kotlin.myapplication.MainActivity"> 


<TextView 
android: layout_width="wrap_ content" 
android: layout_height="wrap content" 
android:text="Hello World!" 
app: layout_constraintBottom_toBottomOf="parent" 
app: layout_constraintLeft_toLeftOf="parent" 
app:layout constraintRight toRightOf="parent" 
app: layout_constraintTop toTopOf="parent" /> 


</android. support.constraint.ConstraintLayout> 


MainActivity.kt 代码 如 下 : 


package com.easy.kotlin.myapplication 


import android. support.v7.app.AppCompatActivity 
import android.os.Bundle 


class MainActivity : AppCompatActivity() { 


override fun onCreate(savediInstanceState: Bundle?) { 
super .onCreate (savedInstanceState) 
setContentView(R.layout.activity main) 


} 


AndroidManifest.xml 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.easy.kotlin.myapplication"> 


<application 
android:allowBackup="true" 
android: icon="@mipmap/ic launcher" 
android: label="@string/app name" 
android: roundIcon="@mipmap/ic launcher round" 
android: supportsRtl="true" 
android: theme="@style/AppTheme"> 
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<activity android:name=".MainActivity"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 


</manifest> 


单 击 功能 菜单 栏 中 的 运行 按钮 ， 运 行程 序 ， 如 图 14-14 所 示 。 


[À MainActivity kt - MyApplication - [~/kotlin/MyApplication] ` m 
myapplication ) 三 MainActivity.kt ) a Gap: kx aBn LD oO 
@ activity_mainxm! x  & MainActivity kt (app x © MyApplication x 


1 package com.easy.kotlin.myapplication v 
2 

3 import android. support. v7. app. AppCompatActivity 

4 import android.os. Bundle 

5 

6 @ class MainActivity : AppCompatActivity() { 

7 

8 of override fun onCreate(savedInstanceState: Bundle?) { 
9 super.onCreate(savedInstanceState) 

10 setContentView(R. layout.activity_main) 

11 } 

12 } 


图 14-14 运行 应 用 程序 


此 时 会 提示 我 们 选择 应 用 程序 部 署 运行 的 目标 设备 ， 如 图 14-15 所 示 。 


eco Select Deployment Target 


Connected Devices 


Vivo Vivo X5V (Android 4.4.4, API 19) 


Create New Virtual Device 


图 14-15 选择 部 署 设备 


s23 * 
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需要 注意 的 是 ， 手 机 要 开启 USB 调试 模式 。 单 击 OK 按钮 ，Android Studio 会 为 我 们 
完成 打包 、 安 装 等 事项 。 最 终 的 运行 效果 如 图 14-16 所 示 。 


ASMA 四 © D 1241 = 100% E 


MyKotlinApplication 


Hello World! 


图 14-16 Hello World 运行 效果 


142 RARA RR: 开发 一 个 电影 指南 应 用 程序 


下 面 我 们 来 开发 一 个 电影 指南 Android 应 用 程序 ， 列 出 流行 /最 高 评级 的 电影 ， 显 示 预 
告 片 和 评论 。 


14.2.1 创建 Kotlin Android 项 目 


首先 创建 一 个 Kotlin Android 项 目 ， 然 后 单 击 Next 按钮 ， 如 图 14-17 所 示 。 
在 Target Android Devices 界面 中 选择 目标 设备 后 单 击 Next 按钮 ， 如 图 14-18 所 示 。 


DEIER 
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Android 开发 


Create New Project 


Create Android Project 


Application name 


ETI 


Company domain 


kotlin.easy.com 


Project location 


/Users/jack/kotlin/android 


Package name 


com.easy.kotlin 


Include C++ support 
Include Kotlin support 


图 14-17 


Target Android Devices 


Select the form factors and minimum SDK 


Phone and Tablet 
API 23: Android 6.0 (Marshmallow) 


Include Android instant App support 

Wear 

API 21: Android 5.0 (Lollipop) 
TV 

API 21: Android 5.0 (Lollipop) 
Android Auto 
Android Things 

API 24: Android 7.0 (Nougat) 


图 14-18 选择 目 


@ The application name for most apps begins with an uppercase letter 


Some devices require additional SDKs. Low API levels target more devices, but offer fewer API features. 


By targeting API 23 and later, your app will run on approximately 39.3% of devices. Help me choose 


Edit 


Cancel 


创建 Kotlin Android 项 目 


Create New Project 


Cancel Previous 


标 设备 


然后 在 Add an Activity to Mobile 界面 中 添加 一 个 Master/Detail Flow, "itt Next 按钮 ， 


如 图 14-19 所 示 。 
在 Configure Activity 界面 中 配置 Activity, 4 


fii Finish 完成 配置 ， 如 图 14-20 所 示 。 


A 
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LE Create New Project 


Lë Add an Activity to Mobile 


Le 


Master/Detail Flow Navigation Drawer Activity Scrolling Activity Settings Activity 


Cancel Previous | BEER rs 


图 14-19 添加 Master/Detail Flow 


eco emm Create New Project 


KÉ) Configure Activity 


Creates a new master/detail flow, allowing users to view a collection of objects 
as well as details for each object. This flow is presented using two columns on 
tablet-size screens and one column on handsets and smaller screens. This 
template creates two activities, a master fragment, and a detail fragment. 


Object Kind 


item 


Object Kind Plural 


items 


Title 
[rems] 


Hierarchical Parent 


Cancel | [ Previous | | ve | BS 


图 14-20 BE Activity 
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最 终生 成 的 Android 项 目 工程 目录 结构 如 图 14-21 所 示 。 
~ @ + | He 上 


> B manifests 
v Mjava 
了 Bacom.easy.kotlin 
> Badummy 
Gz > ltemDetailActivity 
fè & ltemDetailFragment 
Ex RombictActivity 
» Ea com easy kon (androidTest) 
> Bacom.easy.kotlin (test) 
v Rzres 
v Ea drawable 
4 ic_launcher_background.xml 
4 ic_launcher_foreground.xml (v24) 
v Balayout 
4 activity_item_detail.xml 
4 activity_item_list.xml 
起 item_detail.xml 
> Emitem_list.xml (2) 
@item_list_content.xml 
了 Ea mipmap 
> Baic launcher.png (5) 
4 ic_launcher.xml (anydpi-v26) 
> Bwic_launcher_round.png (5) 
4 ic_launcher_round.xml (anydpi-v26) 
Y Ba values 
4 colors.xml 
总 dimens.xml 
4 strings.xml 
4 styles.xml 
了 © Grade Scripts 
(5 build.gradle (Project: android) 
(È build.gradle (Module: app) 
i, gradle-wrapper.properties (Gradle Version) 
@ proguard-rules.pro (ProGuard Rules for app) 
Si gradle.properties (Project Properties) 
(© settings.gradle (Project Settings) 
#;local.properties (SDK Location) 


图 14-21 Android 项 目 工程 目录 结构 


运行 之 后 的 列表 页 如 图 14-22 所 示 。 
选择 Dem) 进入 详情 页 ， 如 图 14-23 所 示 。 
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ZSM ëm OM 2019 = 100% 


电影 指南 


1 tem 1 无 SIM D D 20:20 今 100% 
2 tem 2 
3 tem 3 
4 tem 4 
rane Details about Item: 1 
More details information here. 

6 tem 6 
7 item 7 
8 tem 8 
9 tem 9 
10 Item 10 

图 运行 之 后 的 列表 页 图 14-23 BEA Iteml 详情 页 


其 中 AndroidManifest.xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.easy.kotlin"> 


<application 
android:allowBackup="true" 
android: icon="@mipmap/ic launcher" 
android: label="@string/app name" 
android: roundIcon="@mipmap/ic launcher round" 
android: supportsRtl="true" 
android: theme="@style/AppTheme"> 
<activity 
android:name=".ItemListActivity" 
android: labe. @string/app_name" 
android: theme="@style/AppTheme .NoActionBar"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
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</activity> 
<activity 
android:name=".ItemDetailActivity" 
android: label="@string/title item detail" 
android:parentActivityName=".ItemListActivity" 
android: theme="@style/AppTheme .NoActionBar"> 
<meta-data 
android:name="android.support.PARENT ACTIVITY" 
android: value="com.easy.kotlin.ItemListActivity" /> 
</activity> 
</application> 


</manifest> 


H+, android.intent.action MAIN 处 的 配置 指定 了 应 用 程序 的 启动 Activity 
为 .ItemListActivity， 其 中 的 点 号 “.” 表 示 该 类 位 于 package="com.easy.kotlin" 路 径 下 。 


<activity 
android:name=".ItemListActivity"” 
android: label="@string/ app name" 
android: theme="@style/AppTheme .NoActionBar"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 
<category android:name="android.intent.category. LAUNCHER" /> 
</intent-filter> 
</activity> 


14.2.2 ”启动 主 类 ltemListActivity 


下 面 来 介绍 应 用 程序 的 启动 主 类 ItemListActivity。ItemListActivity 的 Kotlin 代码 如 下 : 
package com.easy.kotlin 


import android.content.Intent 

import android.os.Bundle 

import android. support.v7.app.AppCompatActivity 
import android.support.v7.widget.RecyclerView 
import android.support.design.widget.Snackbar 
import android.view.LayoutInflater 

import android.view.View 

import android.view.ViewGroup 

import android.widget.TextView 


import com.easy.kotlin.dummy.DummyContent 
import kotlinx.android.synthetic.main.activity item list.* 
import kotlinx.android.synthetic.main.item_list_content.view.* 


import kotlinx.android.synthetic.main.item_list.* 


class ItemListActivity : AppCompatActivity() { 


[** 

* Whether or not the activity is in two-pane mode, i.e. running on a tablet 
* device. 

sj 


private var mTwoPane: Boolean = false 
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override fun onCreate (savedInstanceState: Bundle?) { 
super .onCreate (savedInstanceState) 
setContentView(R.layout.activity item list) 


setSupportActionBar (toolbar) 
toolbar.title = title 


fab.setOnClickListener { view -> 
Snackbar .make (view, "Replace with your own action", Snackbar.LENGTH_ LONG) 
-setAction("Action", null) .show() 


} 


if (item_detail_container != null) { 
//The detail container view will be present only in the 
//large-screen layouts (res/values-—w900dp) . 
//If this view is present, then the 
//activity should be in two-pane mode. 
mTwoPane = true 

} 

setupRecyclerView(item list) // 设 置 RecyclerView 

} 


private fun setupRecyclerView(recyclerView: RecyclerView) { 


recyclerView.adapter = SimpleItemRecyclerViewAdapter (this, DummyContent. 
ITEMS, mTwoPane) 


} 


class SimpleItemRecyclerViewAdapter ( 

private val mParentActivity: ItemListActivity, 

private val mValues: List<DummyContent.DummyItem>, 

private val mTwoPane: Boolean) : 
RecyclerView.Adapter<SimpleItemRecyclerViewAdapter.ViewHolder>() { 


private val mOnClickListener: View.OnClickListener 
init { 
mOnClickListener = View.OnClickListener { v -> 
val item = v.tag as DummyContent.DummyItem 
if (mTwoPane) { 
val fragment = ItemDetailFragment()-.apply { 
arguments = Bundle() 
arguments .putString(ItemDetailFragment.ARG ITEM ID, 
item.id) 
} 
mParentActivity.supportFragmentManager 
-beginTransaction () 
-replace (R.id.item detail container, fragment) 
.commit () 
} else { 
val intent = Intent (v.context, ItemDetailActivity::class. 
java) .apply { 
putExtra (ItemDetailFragment.ARG ITEM ID, item.id) 
} 


v.context.startActivity (intent) 
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override fun onCreateViewHolder (parent: ViewGroup, viewType: Int): 
ViewHolder { 
// 设 置 LayoutInflater 
val view = LayoutInflater.from(parent.context) 
-inflate(R.layout.item list content, parent, false) 
return ViewHolder (view) 


} 


override fun onBindViewHolder (holder: ViewHolder, position: Int) { 
val item = mValues [position] 
holder.mIdView.text = item.id 
holder.mContentView.text = item.content 


with (holder.itemView) { 
tag = item 
setOnClickListener (mOnClickListener) 


} 


override fun getItemCount(): Int { 
return mValues.size 


} 


inner class ViewHolder (mView: View) : RecyclerView.ViewHolder (mView) { 
val mIdView: TextView = mView.id text 
val mContentView: TextView = mView.content 


} 
布局 文件 XML 代码 中 的 activity_item_list.xml 代码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<android.support.design.widget.CoordinatorLayout 
xmlns:android="http: //schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android: layout_height="match_parent" 
android: fitsSystemWindows="true" 
tools:context="com.easy.kotlin.ItemListActivity"> 


<android. support .design.widget.AppBarLayout 
android: id="@+id/app bar" 
android: layout width="match parent" 
android: layout height="wrap content" 
android: theme="@style/AppTheme .AppBarOverlay"> 


<android.support.v7.widget.Toolbar 
android: id="@+id/toolbar" 
android: layout_width="match_ parent" 
android:layout height="?attr/actionBarSize" 
app: popupTheme="@style/AppTheme.PopupOverlay" /> 


</android. support .design.widget .AppBarLayout> 
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<FrameLayout 
android: id="@+id/frameLayout" 


android:layout width: 


atch parent" 


android:layout height="match parent" 


app: layout _behavior= 


<include layout="@layout/item list" /> 
</FrameLayout> 


<android. support .design.widget.FloatingActionButton 
android: id="@+id/fab" 
android:layout width="wrap content" 
android: layout height="wrap content" 
android: layout_gravity="bottom|end" 
android: layout margin="@dimen/fab margin" 


app: srcCompat="@android:drawable/ic_ dialog email" /> 


</android. support .design.widget .CoordinatorLayout> 


对 应 的 UL 设计 效果 图 如 图 14-24 所 示 。 


Item 0 


Item 17 


Item 2 


Item 3 


Item 4 


Item 5 


Item 6 


Item 7 


Item 8 


Subltem 0 


Subltem 1 


Subltem 2 


Subltem 3 


Subltem 4 


Subltem 5 


Subltem 6 


Subltem 7 


Subltem 8 
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图 14-24 列表 页 的 UI 设计 图 


14.2.3 AppCompatActivity 类 介绍 


在 使 用 Android Studio 开发 Android 应 用 的 时 候 ， 创 建 项 目 时 ， 


@string/appbar scrolling view behavior"> 


自动 继承 的 是 


第 14 章 ”使 用 Kotlin 进行 Android 开发 


AppCompatActivity。 这 样 我 们 可 以 在 自 定义 的 Activity 类 中 添加 android.support.v7.app. 


ActionBar (APIlevel7+) 。 例 如 activity_item list.xml 布局 中 的 


<android.support.design.widget .AppBarLayout 
android: id="@t+id/app bar" 
android:layout width="match parent" 
android:layout height="wrap content" 
android: theme="@style/AppTheme .AppBarOverlay"> 


<android.support.v7.widget.Toolbar 

android: id="@tid/toolbar" 

android: layout width="match parent" 

android: layout_height="?attr/actionBarSize" 

app: popupTheme="@style/AppTheme.PopupOverlay" /> 
</android. support .design.widget .AppBarLayout> 
Activity 中 添加 Toolbar 的 代码 如 下 : 
class ItemListActivity : AppCompatActivity() { 


/** 


* Whether or not the activity is in two-pane mode, i.e. running on a tablet 


* device. 
*/ 


private var mTwoPane: Boolean = false 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate (savedInstanceState) 
setContentView(R.layout.activity item list) 


setSupportActionBar (toolbar) 
toolbar.title = title 


fab.setOnClickListener { view -> 
Snackbar.make(view, "Replace with your own action", 
LENGTH LONG) .setAction("Action", null) .show() 

} 


if (item_detail_container != null) { 


//The detail container view will be present only in the 


//large-screen layouts (res/values-—w900dp) . 
//If this view is present, then the 
//activity should be in two-pane mode. 
mTwoPane = true 


} 


setupRecyclerView(item_ list) 


i 


Snackbar. 


AppCompatActivity 背后 继承 的 也 是 Activity。Android 5.0 推出 之 后 ， 提 供 了 很 多 新 功 


能 ， 于 是 support v7 也 更 新 了 ， 出 现 了 AppCompatActivity。AppCompatActivity 是 


代 ActionBarActivity 的 。AppCompatActivity 的 类 图 继承 层次 如 图 14-25 所 示 。 
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Activity 


一 一 一 一 一 一 


SupportActivity | me -> LifecycleOwner 


A 


BascFragmentActivityApil4 


y 


BaseFragmentActivityApi16 


— ____ 


SC 
| 
| 
L- FragmentActivity r 
| | 
| | 
| 
—+- TaskStackBuilder. 
1 SupportParentable 
l 
1 
| 
1 
| 
| 
| 


ResultCallback 


ActivityCompat.OnRequestPermissions k 


— >) AppCompatCallback 


ActivityCompat.RequestPermissions 
RequestCode Validator 


ActionBarDrawerToggle. 
DelegateProvider 


(II 


图 14-25 AppCompatActivity 的 类 图 继承 层次 


14.2.4 Activity 生命 周期 


Activity 的 生命 周期 示意 图 如 图 14-26 所 示 〈 图 来 自 官 网 )。 

相信 不 少 朋友 已 经 看 过 这 个 流程 图 了 ， 这 里 面 简单 说 明 一 下 。 

(1) 开始 启动 Activity， 系 统 会 先 调 用 onCreate0 方 法 ， 然 后 调用 onStart0 方 法 ， 最 后 
调用 onResume() 方 法 ，Activity 进入 运行 状态 。 

(2) 当前 Activity 被 其 他 Activity 覆盖 或 被 锁 屏 系统 会 调用 onPause0) 方 法 ， 和 暂停 当 
前 Activity 的 执行 。 

G) 当前 Activity 由 被 覆盖 状态 回 到 前 台 或 解锁 屏 : 系统 会 调用 onResume() 方 法 ， 再 
次 进入 运行 状态 。 

(4) 当前 Activity 转 到 新 的 Activity 界面 或 按 Home 键 回 到 主屏 : 系统 会 先 调 用 
onPause() 方 法 ， 然 后 调用 onStop0 方 法 ， 进 入 停止 状态 。 
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User navigates 
back to the 
activity 


The activity 
comes to the 
foreground 


The activity 
comes to the 
foreground 


Another activity comes 
in front of the activity 


Other applications 
need memory 


(CC The activity is no longer visible) 


Peer ` 
[ | 


Ml 


图 14-26 Activity 的 生命 周期 


(5) 用 户 后 退 到 此 Activity: 系统 会 先 调用 onRestart() 方 法 ， 然 后 调用 onStart0 方 法 ， 
最 后 调用 onResume( 方 法 ， 再 次 进入 运行 状态 。 


(6) 当前 Activity 处 于 被 覆盖 状态 或 者 后 台 不 可 见 状 态 ， 即 第 (2) 步 和 第 (4) 步 ， 


系统 内 存 不 足 ，“ 杀 死 ” 当 前 Activity。 而 后 用 户 退 回 当前 Activity: 再 次 调用 onCreate() 
方法 、onStart( 方 法 和 onResume() 方 法 进入 运行 状态 。 
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(7) 用 户 退 出 当前 Activity: 系统 先 调 用 onPause(0 方 法 ， 然 后 调用 onStop0 方 法 ， 最 
后 调用 onDestory 方法 ， 结 束 当前 Activity。 
这 个 过 程 可 以 用 下 面 的 状态 图 来 简单 说 明 ， 如 图 14-27 所 示 。 


ss 1 
i | 
i 可 视 化 生命 周期 onResume | 
! i 
i i 
i 完全 可 见 i 
| 部 分 可 见 | 
i ® i 
i Resumed | 
! onResume © ! 
| Paused i 
| i 
H i 
i i 
i i 
i i 
f i 
| i 


onCreate 
onStop 


onRestart ` onStart 


E? 
IN 


CINDROID 


© 
Stopped 
不 可 见 


onDestroy 


Destroyed 


图 14-27 Activity 状态 图 


14.2.5 Kotlin Android Extensions 插件 


在 上 面 的 ItemListActivity.onCreate 函数 中 ， 其 中 的 这 行 代码 

setSupportActionBar (toolbar) 
是 设置 支持 的 ActionBar(0 方 法 。 但 是 我 们 发 现 这 里 并 没有 使 用 findViewById0 方 法 来 获取 
android:id="@+id/toolbar"Toolbar 的 View 对 象 ， 之 前 我 们 可 能 都 是 这 样 写 的 : 

Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar) ; 

setSupportActionBar (toolbar) ; 
而 这 里 直接 使 用 了 toolbar 这 个 Toolbar 的 对 象 变量 .这 是 怎么 做 到 的 呢 ? 其 实 是 通过 Kotlin 
Android Extensions 插件 做 到 的 。 我 们 在 app 目录 下 的 Gradle 配置 文件 build.gradle 中 添加 
了 以 下 配置 : 


-226 * 


第 14 章 ”使 用 Kotlin 进行 Android 开发 


apply plugin: 'com.android.application' 

apply plugin: 'kotlin-android' 

apply plugin: 'kotlin-android-extensions' 

有 了 这 个 插件 ， 就 可 以 永远 与 find ViewByld 说 再 见 了 。Kotlin Android Extensions Ji 
TEE Kotlin 针对 Android 开发 专门 定制 的 通用 插件 ， 通 过 它 能 够 以 极 简 的 无 缝 方式 实现 从 
Activity、Fragment 和 View 布局 组 件 中 创建 和 获取 视图 View。 使 用 Kotlin 开发 Android 大 
大 减少 了 我 们 的 样板 代码 。 

就 像 上 面 的 示例 代码 一 样 ， 只 要 在 代码 中 直接 使 用 这 个 布局 组 件 的 ID 名 称 作 为 变量 
名 即 可 ， 剩 下 的 部 分 Kotlin 插件 会 全 部 “搞定 ”。Kotlin Android Extensions 插件 将 会 生成 
一 些 额 外 的 代码 ， 使 我 们 可 以 在 布局 XML 中 直接 通过 ID 获取 到 其 View 对 象 。 另 外 ， 
还 会 生成 一 个 本 地 视图 缓存 ， 当 第 一 次 使 用 属性 时 ， 将 执行 一 个 常规 的 fndViewById。 但 
在 下 一 次 使 用 属性 的 时 候 ， 视 图 将 从 缓存 中 恢复 ， 因 此 访问 速度 将 更 快 。 

只 要 在 布局 中 添加 一 个 View， 在 Activity, View, Fragment 中 都 可 以 直接 用 ID 来 引 
用 这 个 View。Kotlin 把 Android 编程 极 简 的 风格 发 挥 得 淋 注 尽 致 。 

我 们 可 以 通过 Kotlin 对 应 的 字 节 码 来 更 加 深入 地 理解 Kotlin 所 做 的 事情 。Android 
Studio 中 与 IDEA 一 样 提供 了 Kotlin 的 工具 箱 。 在 菜单 栏 中 依次 选择 Tools | Kotlin | Show 
Kotlin Bytecode 命令 ， 如 图 14-28 所 示 。 


Code Analyze Refactor Build Run SH VCS Window Help ` BS œ wg Dsg 108298 WA 23:39:52 


D Tasks & Contexts r 
[TtemListActivity IC onCreate, Save File as Template... ` x 


27 class ItemListActivity : N Generate JavaDoc... 


29 Ven Create Command-line Launcher... 

30 * Whether or not the | Dring on a tablet 

31 * device. 此 Firebase 

2 a © App Links Assistant 

33 rivate var pTwoPane: | 

34 E sf Android > | 

35 et override fun Kéiere, Configure Kotlin in Project 

36 super .onCresta: Configure Kotlin (JavaScript) in Project | 
A setContentView(R. layout.activity_item_list) Cm Kotlin Plugin Updates 
39 Een how Kotlin Bytecode 

HI toolbar. title = le To Java 

41 

a fab. setOnClickListener { view -> Kotin internal Mode | 
43 Snackbar.make(view, text: “Replace with your own act ` "e Kotlin REPL 

44 +SetAction( text: "Action", listener null). showtr 

45 

46 S 

47 if ae ee container != null) { 

48 / The detail container view will be present only in the 

49 多 large-screen layouts (res/values-w900dp) 

50 // If this view is present, then the 

51 // activity shoutd be in two-pane mode. 

52 TwoPane = true 

53 D 

54 

55 $ SetupRecyclerView(item_list) 

56 


图 14-28 ”依次 选择 Tools | Kotlin | Show Kotlin Bytecode 命令 


之 后 将 会 看 到 如 图 14-29 所 示 的 Kotlin Bytecode 界面 。 


SE 


Kotlin 从 入 门 到 进 阶 实 战 


Kotlin Bytecode le 
Decompile Inline Optimization Assertions (| IR "` JVM8 target 2 

可 puocrc ramat Crass COM easy/ KUTUN ICEMCISUACUIVITY eens emt AT SUPPUT t7 V770% ™ 

5 

6 
17 // access flags @x2 

8 private Z mTwoPane 

9 

10 // access flags 0x4 

11 protected onCreate(Landroid/os/Bundle; )V 

12 @Lorg/jetbrains/annotations/Nullable;() // invisible, parameter @ 

13 Le 

14 LINENUMBER 36 LO 

15 ALOAD @ 

16 ALOAD 1 

17 INVOKESPECIAL android/support/v7/app/AppCompatActivity.onCreate (Landroid/os/ 

18 L1 

19 LINENUMBER 37 L1 
1 20 ALOAD @ 

1 21 LDC 2131361820 

22 INVOKEVIRTUAL com/easy/kotlin/ItemListActivity.setContentView (I)V 

23 
| 24 LINENUMBER 39 L2 

25 ALOAD @ 

26 ALOAD @ 

27 GETSTATIC com/easy/kotlin/R$id.toolbar : I 

28 INVOKEVIRTUAL com/easy/kot Lin/ItemListActivity._$ findCachedViewById (I)Land 

29 CHECKCAST android/support/v7/widget/Toolbar 

30 INVOKEVIRTUAL com/easy/kot Lin/ItemListActivity.setSupportActionBar (Landroid, 

31 L3 

32 LINENUMBER 4@ L3 

33 ALOAD @ 

34 GETSTATIC com/easy/kotlin/R$id.toolbar : I 
\ 35 INVOKEVIRTUAL com/easy/kotlin/ItemListActivity._$_findCachedViewById (I)Landr 
H 36 CHECKCAST android/support/v7/widget/Toolbar 

37 ALOAD @ 

38 INVOKEVIRTUAL com/easy/kotlin/ItemListActivity.getTitle ()Ljava/lang/CharSequ 
€ 39 INVOKEVIRTUAL android/support/v7/widget/Toolbar.setTitle (Ljava/lang/CharSequ 
d 40 L4 
LE LINENUMBER 42 L4 


图 14-29 Kotlin Bytecode 界面 


其 中 ， 下 面 的 两 行 代码 ; 


setSupportActionBar (toolbar) 
toolbar.title = title 


对 应 的 字 节 码 如 下 : 
LINENUMBER 39 L2 
ALOAD 0 
ALOAD 0 


GETSTATIC com/easy/kotlin/R$id.toolbar : I 

INVOKEVIRTUAL com/easy/kotlin/ItemListActivity. $ findCachedViewById 
(I) Landroid/view/View; 

CHECKCAST android/support/v7/widget/Toolbar 

INVOKEVIRTUAL com/easy/kotlin/ItemListActivity.setSupportActionBar 
(Landroid/support/v7/widget/Toolbar;)V 

L3 

LINENUMBER 40 L3 

ALOAD 0 

GETSTATIC com/easy/kotlin/R$id.toolbar : I 

INVOKEVIRTUAL com/easy/kotlin/ItemListActivity. $ findCachedViewById 
(I) Landroid/view/View; 

CHECKCAST android/support/v7/widget/Toolbar 

ALOAD 0 

INVOKEVIRTUAL com/easy/kotlin/ItemListActivity.getTitle ()Ljava/lang/ 
CharSequence; 
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INVOKEVIRTUAL android/support/v7/widget/Toolbar.setTitle (Ljava/lang/ 
CharSequence; ) V 
L4 


其 实 从 字 节 码 中 


GETSTATIC com/easy/kotlin/R$id.toolbar : I 
INVOKEVIRTUAL com/easy/kotlin/ItemListActivity. $ findCachedViewById 


我 们 已 经 看 到 了 Kotlin 所 做 的 事情 了 。 反 编译 成 Java 代码 可 能 会 看 得 更 加 清楚 : 


public final class ItemListActivity extends AppCompatActivity { 
private boolean mTwoPane; 
private HashMap $ findViewCache; 


protected void onCreate(@Nullable Bundle savedInstanceState) { 
super. onCreate (savedInstanceState) ; 
this .setContentView (2131361820) ; 
this.setSupportActionBar ( (Toolbar) this. $ findCachedViewById(id.toolbar) ) ; 
((Toolbar) this. $ findCachedViewById (id.toolbar) ) .setTitle (this.getTitle()); 


} 


public View $ findCachedViewById(int varl) { 
if(this. $ findViewCache == null) { 
this. $ findViewCache = new HashMap (); 
} 


View var2 = (View)this. $ findViewCache.get (Integer.valueOf (var1) ); 
if(var2 == null) { 

var2 = this. findViewBylId(var1l) ; 

this. $ findViewCache.put (Integer.valueOf(varl), var2); 


} 


return var2; 


} 
其 中 ，ItemListActivity 类 中 HashMap 类 型 的 私有 成 员 变量 SfindViewCache 就 是 本 地 


缓存 。 这 里 其 实 反映 出 了 Kotlin 语言 设计 的 核心 思想 : 通过 对 Java 更 高 一 层 的 封装 ， 不 仅 
大 大 简化 了 样板 化 的 代码 量 ， 同 时 根据 一 些 特定 的 可 以 优化 的 问题 场景 ， 提 供 了 更 好 的 
性 能 。 

同样 的 ， 上 面 代码 中 的 fab 变量 : 


fab.setOnClickListener { view -> 
Snackbar.make(view, "Replace with your own action", Snackbar.LENGTH LONG) 
-setAction("Action", null) .show() 


i 


也 是 直接 使 用 的 布局 XML 中 的 android:id="@+id/fab": 


<android.support.design.widget.FloatingActionButton 
android: id="@+id/fab" 
android: layout_width="wrap_ content" 
android: layout _height="wrap_content" 
android: layout_gravity="bottom|end" 
android: layout_margin="@dimen/fab_ margin" 
app: srcCompat="@android:drawable/ic dialog email" /> 
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item detail container、setupRecyclerView(item list) 中 的 item list 都 是 使 用 了 上 面 的 方 
式 ， 这 样 代码 确实 精简 了 许多 。 
上 面 的 activity_item list.xml 布局 中 肉 套 的 FrameLayout 布局 配置 如 下 : 


<FrameLayout 
android:id="@+id/frameLayout" 
android: layout_width="match_ parent" 
android: layout_height="match_parent" 
app: layout_behavior="@string/appbar_ scrolling view _behavior"> 


<include layout="@layout/item list" /> 


</FrameLayout> 


其 中 ,<include layout="@layout/item_list"/>#é784| FH] layout 文件 夹 下 面 的 item_listxml， 
item_list.xml 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<android.support.v7.widget .RecyclerView 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
xmlns:tools="http://schemas.android.com/tools" 
android:id="@tid/item list" 
android:name="com.easy.kotlin.ItemListFragment" 
android:layout width="match parent" 
android: layout_height="match_parent" 
android:layout marginLeft="16dp" 
android:layout marginRight="16dp" 
app: layoutManager="LinearLayoutManager" 
tools:context="com.easy.kotlin.ItemListActivity" 
tools: listitem="@layout/item_list_content" /> 


而 布局 item_list.xml 中 的 tools:listitem="@layout/item_list_content"#é784|}1] Y layout 
文件 夹 下 面 的 item_list_content.xml 布局 文件 。 


<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android: orientation="horizontal"> 


<TextView 
android:id="@tid/id text" 
android: layout_width="wrap_content" 
android: layout_height="wrap_content" 
android: layout margin="@dimen/text margin" 
android: textAppearance="?attr/textAppearanceListItem" /> 


<TextView 
android: id="@tid/content" 
android: layout width="wrap content" 
android: layout_height="wrap Content" 
android:layout margin="@dimen/text margin" 
android: textAppearance="?attr/textAppearanceListItem" /> 
</LinearLayout> 
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14.2.6 详情 页 ltemDetailActivity 


ItemDetailActivity 是 Item 详情 页 的 Activity， 对 应 的 Kotlin 代码 如 下 : 


package com.easy.kotlin 


import 
import 
import 
import 
import 
import 


/** 


android.content.Intent 

android.os.Bundle 

android. support .design.widget .Snackbar 

android. support.v7.app.AppCompatActivity 
android.view.MenuItem 
kotlinx.android.synthetic.main.activity item detail: 


* An activity representing a single Item detail screen. This 

* activity is only used on narrow width devices. On tablet-size devices, 

* item details are presented side-by-side with a list of items * ina 
{[ItemListActivity] . 


*/ 


class ItemDetailActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 


super .onCreate (savedInstanceState) 
setContentView(R.layout.activity item detail) 
setSupportActionBar (detail toolbar) 


fab.setOnClickListener { view -> 
Snackbar.make (view, "Replace with your own detail action", Snackbar. 
LENGTH LONG) 
.-setAction("Action", null) .show() 


} 


//Show the Up button in the action bar. 
supportActionBar?.setDisplayHomeAsUpEnabled (true) 


//savedInstanceState is non-null when there is fragment state 
//saved from previous configurations of this activity 
//(e.g. when rotating the screen from portrait to landscape). 
//In this case, the fragment will automatically be re-added 
//to its container so we don't need to manually add it. 
//For more information, see the Fragments API guide at: 
// 
//nttp://developer.android.com/guide/components/fragments.html 
ti 
if (savedInstanceState == null) { 
//Create the detail fragment and add it to the activity 
//using a fragment transaction. 
val arguments = Bundle() 
arguments .putString (ItemDetailFragment.ARG ITEM ID, 
intent.getStringExtra(ItemDetailFragment.ARG ITEM ID)) 
val fragment = ItemDetailFragment () 
fragment.arguments = arguments 
// 处 理 提交 Fragment 的 事务 
supportFragmentManager -beginTransaction() 
-add(R.id.item detail container, fragment) 
-commit () 
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} 


override fun onOptionsItemSelected(item: MenuItem) = 
when (item.itemId) { 
android.R.id-home -> { 
//This ID represents the Home or Up button. In the case of this 
//activity, the Up button is shown. For 
//more details, see the Navigation pattern on Android Design: 
// 
//http://developer.android.com/design/patterns/navigation. 
html #up- vs-back 


navigateUpTo (Intent (this, ItemListActivity::class.java) ) 
true 


} 


else -> super.onOptionsItemSelected (item) 


} 
UI 布局 XML 文件 的 item_detail.xml 内 容 如 下 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match parent" 
android: fitsSystemWindows="true" 
tools:context="com.easy.kotlin.ItemDetailActivity" 
tools: ignore="MergeRootFrame"> 


<android.support.design.widget .AppBarLayout 
android: id="@+id/app bar" 
android: layout width="match parent" 
android:layout height="@dimen/app bar height" 
android: fitsSystemWindows="true" 
android: theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar"> 


<android.support .design.widget .CollapsingToolbarLayout 
android:id="@tid/toolbar layout" 
android: layout_width="match_parent" 
android:layout height="match parent" 
android: fitsSystemWindows="true" 
app:contentScrim="?attr/colorPrimary" 
app:layout scrollFlags="scroll|exitUntilCollapsed" 
app: toolbarId="@tid/toolbar"> 


<android. support .v7.widget .Toolbar 
android: id="@+id/detail toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
app: layout_collapseMode="pin" 
app: popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 


</android.support.design.widget .CollapsingToolbarLayout> 


</android.support .design.widget .AppBarLayout> 
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<android.support.v4.widget.NestedScrollView 
android:id="@+id/item detail container" 
android: layout width="match parent" 
android:layout height="match parent" 


app:layout behavior="@string/appbar scrolling view behavior" /> 


<android. support .design.widget.FloatingActionButton 
android: id="@+tid/fab" 
android:layout width="wrap content" 
android: layout_height="wrap content" 
android:layout gravity="center vertical|start" 
android:layout margin="@dimen/fab margin" 
app:layout anchor="@t+id/item detail container" 
app: layout_anchorGravity="top|end" 
app:srcCompat="@android:drawable/stat notify chat" /> 


</android. support .design.widget .CoordinatorLayout> 


打开 item_detailxml， 可 以 看 到 设计 图 的 Ul 效果 如 图 14-30 所 示 。 


tin) rr ) Ba inte) activity em_dealaml Age )h beh oGm AAI 
Fè temDetallactivitvkt =f activity item detalami ` E AppCompatActiviviaw ` (Ë) Fraamentactivitviava » D BaseFragmentAcivitvaniiGiava ` Či BaseFraamertActivityAsit4java ES 
Palette org, S- DNews4- — 26+ ONoActionBar © Language ~ v 
D % Button E GER 
widgets Fl ToggleButton F 
Ges Chock3ox i 
E © RadioButton 
© CheckedTextView 
Containers | Z Spinner 
GE C ProgressBar 
Date = ProgressBar (Horizontal) 
Transitions -»- SeekBar 
Advanced 9 SeekBar (Discrete) 
Google 回 QuickcontactBadge 
| Design Rating3er 
AppCompat Switch 
j Hspoce 
Ab TextView 
加 Pain Text 
8 Password 
l “a Password (Numeric) 
画 E-mall 
Component Tee er 
Y M CoordinatorLayout 
v app bar (AppBarLayout) 
7 Z toolbar layout (Collapsing Toolbarlayout) 
detail_toolbar (Toolbar) 
[Clitem_detail_container (NestedScrollView) 
© fab (FloatingActionButton) 
Design | Text 
ArdroidProfier Ei Q:Messeges än T000 


Qlevert Log ` E Gradie Console 
Yesterday 209) Na Conte 


图 14-30 item detail.xml 设计 图 的 UI 效果 


可 以 看 到 ， 详 情 页 的 布局 主要 有 3 大 块 ， 分 别 是 AppBarLayout、NestedScrollView 和 
FloatingActionButton 。 


在 ItemDetailActivity 的 onCreate0 函 数 里 的 


setContentView(R.layout.activity item detail) 
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设置 详情 页 ItemDetailActivity 的 显示 界面 中 使 用 activity item detail xml 布局 文件 进行 
布局 : 


setSupportActionBar (detail toolbar) 


设置 详情 页 的 android.support.v7.widget.Toolbar 控件 布局 。 
下 面 来 看 在 ItemDetailActivity 中 创建 ItemDetailFragment 的 过 程 。 代 码 如 下 : 


override fun onCreate(savedInstanceState: Bundle?) { 


if (savedInstanceState == null) { 

//Create the detail fragment and add it to the activity 

//using a fragment transaction. 

val arguments = Bundle() 

arguments.putString (ItemDetailFragment.ARG ITEM ID, 
intent .getStringExtra (ItemDetailFragment.ARG ITEM ID) ) 

val fragment = ItemDetailFragment () 

fragment.arguments = arguments 

supportFragmentManager.beginTransaction() 
-add(R.id.item_detail container, fragment) 
.commit () 


} 


(1) 首先 判断 当前 savedInstanceState EEH. WRAZ, PUTER (2) 。 
(2) 创建 ItemDetailFragmentQ wR, JFK AIL Bundle 信息 (Fragment 中 的 成 员 变量 
mArguments) 如 下 : 


val arguments = Bundle() 

arguments.putString(ItemDetailFragment.ARG ITEM ID, 
intent.getStringExtra(ItemDetailFragment.ARG ITEM ID)) 

val fragment = ItemDetailFragment () 

fragment.arguments = arguments 


(3) 通过 supportFragmentManager 添加 Fragment 与 布局 空间 的 映射 关系 。 
supportFragmentManager .beginTransaction () 
-add(R.id.item detail container, fragment) 
.- commit () 
Jt, supportFragmentManager 用 来 获取 能 管理 和 当前 Activity 有 关联 的 Fragment 的 
FragmentManager, 使 用 supportFragmentManager 可 以 向 Activity 状态 中 添加 一 个 Fragment。 
上 面 代码 中 的 Riditem detail container 对 应 的 布局 是 一 个 NestedScrollView， 代 码 
如 下 : 
<android.support.v4.widget .NestedScrollView 
android:id="@+id/item detail container" 
android:layout width="match parent" 


android:layout height="match parent" 
app: layout_behavior="@string/appbar_ scrolling view behavior" /> 


UI 界面 的 设计 效果 图 如 图 14-31 所 示 。 
最 后 需要 注意 的 是 ， 如 果 当 前 Activity 在 前 面 已 经 保存 了 Fragment 状态 的 数据 ， 那 么 
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savedInstanceState 的 值 就 是 非 空 的 ， 这 个 时 候 我 们 就 不 需要 再 去 手工 创建 Fragment 对 象 保 
存 到 当前 的 Activity 中 了 。 因 为 当 我 们 的 Activty 被 异常 销毁 时 ，Activity 会 对 自身 状态 进 
行 保存 (这 里 包含 了 我 们 添加 的 Fragment) 。 而 在 Activity 被 重新 创建 时 ， 又 会 对 我 们 之 
前 保存 的 Fragment 进行 恢复 。 


©- Dnexus4- = 26 ~ ONoActionBar © Language ~ Attributes 
Dap o o 

layout width nt ` 
layout_height [match parent | 
NestedScrollView 
context a 
# showin ] 
fillViewport z 
clipToPadding H 
Favorite Attributes 
visibility none 
CoordinatorLayoutlayout 
layout_behavior @string/appbar_scrolling | 
layout_anchor ] 
layout_anchorGravity | 


View all attributes = 
图 14-31 NestedScrollView 代码 布局 效果 图 
所 以 ， 添 加 Fragment 前 千 万 要 记得 检查 是 否 有 保存 的 Activity 状态 。 如 果 没 有 状态 保 


存 , 说 明 Activity 是 第 1 次 被 创建 , 我 们 需要 添加 Fragment; 如 果 有 状态 保存 , 说 明 Activity 
刚刚 出 现 过 异常 被 销毁 过 ， 之 前 的 Fragment 会 被 恢复 ， 我 们 不 用 再 添加 Fragment. 


14.2.7 碎片 事务 类 FragmentTransaction 


前 面 的 代码 中 使 用 了 FragmentTransaction 的 add(0) 方 法 ， 该 方法 签名 如 下 : 


public abstract FragmentTransaction add(@IdRes int containerViewId, 
Fragment fragment) ; 


其 中 , 参数 containerViewld 为 传 入 Activity 中 某 个 视图 容器 的 ID。 如 果 containerViewld 
传 入 0， 则 这 个 Fragment 不 会 被 放置 在 一 个 容器 中 。 请 注意 , 不 要 认为 Fragment 没 添 加 进 
来 ， 其 实 我 们 只 是 添加 了 一 个 没有 视图 的 Fragment 而 已 ， 这 个 Fragment 可 以 用 来 做 一 些 
类 似 于 Service 的 后 台 工 作 。 


"Ss 


Kotlin 从 入 门 到 进 阶 实 战 


FragmentTransaction 常用 的 API 如 表 14-1 所 示 。 


表 14-1 FragmentTransaction 常 用 的 API 方 法 
API 方 法 说 明 
向 Activity state 中 添加 一 个 Fragment。 参 数 containerViewld 一 般 为 
add(int containerViewld, Fragment | 传 入 Activity 中 某 个 视图 容器 的 ID。 如果 containerViewld 传 入 0, 
fragment, String tag) 则 这 个 Fragment 不 会 被 放置 在 一 个 容器 中 。 添加 Fragment 前 应 检查 
是 否 有 保存 的 Activity 状态 
移 除 一 个 已 经 存在 的 Fragment。Fragment 被 remove 后 ，Fragment 


remove(Fragment fragment) 的 生命 周期 会 一 直 执 行 完 onDetach， 之 后 Fragment 的 实例 也 会 
Fragment Manager 中 被 移 除 

replace(int containerViewId, 替换 一 个 已 被 添加 进 视图 容器 的 Fragment。 之 前 添加 的 Fragment 会 

Fragment fragment) 在 replace 时 被 视图 容器 移 除 


记录 已 提交 的 事务 〈transation) ， 可 用 于 回 退 操作 。 人 参数 name 是 这 
addToBackStack(String name) | 次 回 退 操作 的 一 个 名 称 或 标识 ) ， 不 需要 时 可 以 传 入 null 
show(Fragment fragment) 隐藏 一 个 存在 的 Fragment 
显示 一 个 以 前 被 隐藏 过 的 Fragment。Fragment 被 hide/show， 仅 仅 是 
隐藏 /显示 Fragment 的 视图 ， 不 会 有 任何 生命 周期 方法 的 调用 。 在 
Fragment 中 重 写 onHiddenChanged0 方 法 可 以 对 Fragment 的 hide 和 
show 状态 进行 监听 
重新 关联 一 个 Fragment ( 当 这 个 Fragment 的 detach 执行 之 后 ) 。 当 
Fragment 被 detach 后 ， 执 行 attach Wir, & ik Fragment 从 
attach(Fragment fragment) onCreateView 开始 执行 ， 一 直 执行 到 onResume。attach 无 法 像 add 
- 样 单独 使 用 ， 因 为 如 果 单 独 使 用 会 抛 异常 。 该 方法 存在 的 意义 是 
对 detach 后 的 Fragment 进行 界面 恢复 
分 离 指定 Fragment 的 Ul 视图 。 当 Fragment 被 detach Ja, Fragment 
的 生命 周期 执行 完 onDestroyView0 方 法 就 终止 了 ， 这 意味 着 


hide(Fragment fragment) 


Eeer Fragment 的 实例 并 没有 被 销毁 ,只 是 UI 界 面 被 移 除了 (注意 和 remove 
是 有 区 别 的 ) 
SC imations(int enter, int | 为 Fragment 的 进入 /退出 设置 指定 的 动画 资源 
提交 事务 。 安排 一 个 针对 该 事务 的 提交 提交 并 没有 立刻 发 生 ， 会 
commit() 


安排 到 在 主线 程 下 次 准备 好 的 时 候 来 执行 

同步 提交 这 个 事务 。 任 何 被 添加 的 Fragment 都 将 会 被 初始 化 ， 并 将 
它们 完全 带 入 它们 的 生命 周期 状态 。 使 用 commitNowO 时 不 能 进行 
commitNow() 添加 回 退 栈 的 操作 ， 如 果 使 用 addToBackStack(String) 将 会 抛 出 一 个 
IllegalStateException 的 异常 


下 面 介绍 ItemDetailFragment. 

ItemDetailFragment 表示 单个 Item 的 详细 信息 。 此 片段 在 双 窗 格 模式 〈 在 平板 电脑 上 ) 
包含 在 ItemListActivity 中 , 在 手机 上 则 是 包含 在 ItemDetailActivity 中 。 其 Kotlin 代码 如 下 : 

package com.casy.kotlin 

import android.os.Bundle 

import android.support.v4.app.Fragment 

import android.view.LayoutInflater 


import android.view.View 
import android.view.ViewGroup 
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import com.easy.kotlin.dummy.DummyContent 
import kotlinx.android.synthetic.main.activity item detail.* 
import kotlinx.android.synthetic.main.item_detail.view.* 


class ItemDetailFragment : Fragment() { 
[** 
* Wik? dummy content this fragment is presenting. 
*/ 
private var mItem: DummyContent.DummyItem? = null 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate (savedInstanceState) 


if (arguments.containsKey (ARG ITEM ID)) { 
// 加 载 数据 
mItem = DummyContent .ITEM MAP[arguments.getString(ARG_ITEM ID) ] 
mitem?.let { 
//% toolbar layout 布局 设置 标题 


activity.toolbar layout?.title = it.content 


} 


override fun onCreateView (inflater: LayoutInflater, container: ViewGroup?, 
savedInstanceState: Bundle?): View? { 
val rootView = inflater.inflate(R.layout.item detail, container, false) 


// 在 Text View 中 显示 测试 数据 文本 
mItem?.let { 
rootView.item detail.text = it.details 


} 


return rootView 


} 


companion object 
{ deg 
* The fragment argument representing the item ID that this fragment 
* represents. 
*/ 
const val ARG ITEM ID = "item id" 


} 


在 onCreate() 中 » activity.toolbar_layout?.title=it.content 这 行 代码 是 给 详情 页 ToolBar 的 
大 标题 赋值。 
<android.support.design.widget .AppBarLayout 
android: id="@+tid/app bar" 
android: layout_width="match_parent" 
android:layout height="@dimen/app bar height" 


android: fitsSystemWindows="true" 
android: theme="@style/ThemeOverlay.AppCompat . Dark.ActionBar"> 


<android. support .design.widget .CollapsingToolbarLayout 
android: id="@+id/toolbar layout" 
android: layout width="match parent" 
android: layout_height="match_parent" 
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android: fitsSystemWindows="true" 
app:contentScrim="?attr/colorPrimary" 

app:layout scrollFlags="scroll]exitUntilCollapsed" 
app: toolbarId="@t+id/toolbar"> 


<android.support.v7.widget .Toolbar 


android: id="@tid/detail toolbar" 
android:layout width="match parent" 
android:layout height attr/actionBarSize" 


app: layout_collapseMode="pin" 
app: popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 


</android. support .design.widget .CollapsingToolbarLayout> 


</android. support .design.widget .AppBarLayout> 


对 应 的 UI 效果 图 如 图 14-32 所 示 。 


图 14-32 AppBarLayonut 的 UI 界面 效果 图 


在 onCreateView()'#!, rootView.item_detail.text = (details 这 行 代 码 对 应 的 布局 是 单个 


Item 的 详情 


展示 TextView 视图 ， 其 布局 XML 代码 中 的 item_detail.xml 代码 如 下 : 


<TextView xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android: id="@tid/item detail" 


style 


android:attr/textAppearanceLarge" 


android: layout_width="match parent" 
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android:layout height="match parent" 

android: padding="16dp" 
android:textIsSelectable="true" 
tools:context="com.easy.kotlin.ItemDetailFragment" /> 


UI 效果 图 如 图 14-33 所 示 。 


图 14-33 item_detail.xml 的 布局 UI 效果 图 


14.2.8 Fragment 生命 周期 


Fragment 必须 嵌入 在 Activity 中 才能 生存 ， 其 生命 周期 也 直接 受 宿 主 Activity 生命 周 
期 的 影响 。 例 如 , 若 宿 主 Activity 处 于 pause 状态 , 则 它 所 管辖 的 Fragment 也 将 进入 pause 
状态 。 而 当 Activity 处 于 resume 状态 时 ， 则 可 以 独立 地 控制 每 一 个 Fragment， 如 添加 或 删 
除 等 。 为 了 创建 Fragment， 需 要 继承 一 个 Fragment 类 ， 并 实现 Fragment 的 生命 周期 回调 
方法 ， 如 onCreate0、onStart0、onPause0 和 onStop0 等 。 事 实 上 ， 若 需要 在 一 个 应 用 中 加 
入 Fragment， 只 需要 将 原来 的 Activity 替换 为 Fragment， 并 将 Activity 的 生命 周期 回调 方 
法 简单 地 改 为 Fragment 的 生命 周期 回调 方法 即 可 。Fragment 的 生命 周期 示意 图 如 图 14-34 
所 示 。 


Kotlin 从 入 门 到 进 阶 实战 


Fragment 从 后 台 
恢复 到 布局 layo 


F: 除 
HAN 


14-34 Fragment 的 生命 周期 示意 图 
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另外 ，Fragment 与 Activity 的 生命 周期 对 比如 图 14-35 所 示 。 


Activity State Fragment Callbacks 


Created 


Started per 


Paused 


Stopped 


Destroyed 


图 14-35 Fragment D Activity 的 生命 周期 对 比 


(1) 当 一 个 Fragment 被 创建 的 时 候 ， 会 依次 经 历 以 下 状态 : OnAttach(), onCreate(), 
onCreateView()fil onActivityCreated()。 

(2) 当 这 个 Fragment 对 用 户 可 见 的 时 候 ， 会 经 历 onStart0 和 onResume() 两 个 状态 。 

(3) 当 这 个 fragment 进入 “后 台 模 式 ” 的 时 候 ， 会 经 历 onPause0 和 onStop0 两 个 

(4) 当 这 个 Fragment 被 销毁 了 (或 者 持 有 它 的 Activity 被 销毁 了 ) ， 会 经 历 以 下 状态 : 
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onPause(0、onStop0、onDestroyView0 和 onDetach(). 

(5) 就 像 Activity 一 样 , 在 以 下 状态 中 , 可 以 使 用 Bundle 对 象 保存 一 个 Fragment AS, 
onCreate0、onCreateView0O 和 onActivityCreated(). 

(6) Fragments 的 大 部 分 状态 都 和 Activity 很 相似 ， 但 Fragment 有 一 些 新 的 状态 ， 这 


些 新 状态 如 下 。 
O onAttached0: “4 Fragment fil Activity 关联 之 后 ， 调 用 这 个 方法 ; 


Qa 
u 
Qa 
Qa 


onCreateView(): 创建 Fragment 中 的 视图 时 ， 调 用 这 个 方法 ; 
onActivityCreated(): 当 Activity 的 onCreate() 方 法 被 返回 之 后 ， 调 用 这 个 方法 ; 
onDestroyView(): “4 Fragment 中 的 视图 被 移 除 的 时 候 ， 调 用 这 个 方法 ; 
onDetach(): “4 Fragment 和 Activity 分 离 的 时 候 ， 调 用 这 个 方法 。 


一 般 来 说 ， 在 Fragment 中 应 至 少 重 写 下面 3 个 生命 周期 方法 : 


口 


口 


口 


onCreate(): 当 创 建 Fragment 实例 时 ， 系 统 回调 的 方法 。 在 该 方法 中 ， 需 要 对 一 些 
必要 的 组 件 进行 初始 化 ， 以 保证 这 个 组 件 的 实例 在 Fragment 处 于 pause 或 stop 状 
态 时 仍然 存在 。 

onCreateView(): 当 第 一 次 在 Fragment 上 绘制 UI 时 ， 系 统 回调 的 方法 。 该 方法 返 
回 一 个 View 对 象 , 该 对 象 表示 Fragment 的 根 视图 ; 47 Fragment 不 需要 展示 视图 ， 
则 该 方法 可 以 返回 null. 

onPause(): 当 用 户 离 开 Fragment 时 回调 的 方法 (并 不 意味 着 该 Fragment 被 销毁 ) 。 
在 该 方法 中 ， 可 以 对 Fragment 的 数据 信息 做 一 些 持久 化 的 保存 工作 ， 因 为 用 户 可 
能 不 再 返回 这 个 Fragment。 


大 多 数 情况 下 ， 需 要 重 写 上 述 3 个 方法 ， 有 时 还 需要 重 写 其 他 生命 周期 方法 。 


az 


当 执 行 一 个 Fragment 事务 时 ， 也 可 以 将 该 Fragment 加 入 到 一 个 由 宿主 Activity 管辖 


的 后 退 栈 中 , 并 由 Activity 记录 加 入 到 后 退 栈 的 Fragment 信息 , 按 下 后 退 键 可 以 将 Fragment 
从 后 退 栈 中 一 次 弹出 。 

4% Fragment 添加 至 Activity 的 视图 布局 中 有 两 种 方式 :一 种 是 使 用 Fragment 标签 加 入 。 
Fragment 的 父 视图 应 是 一 个 ViewGroup; 另 一 种 使 用 代码 动态 加 入 ， 并 将 一 个 ViewGroup 
作为 Fragment 的 容器 。 

为 了 方便 ， 继 承 下 面 这 些 特殊 的 Fragment 可 以 简化 其 初始 化 过 程 。 


口 
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DialogFragment: 可 展示 一 个 悬浮 对 话 框 。 使 用 该 类 创建 的 对 话 框 可 以 很 好 地 替换 
由 Activity 类 中 的 方法 创建 的 对 话 框 ， 为 可 以 像 管 理 其 他 Fragment 一 样 管理 
DialogFragment 它们 都 被 压 入 由 宿主 Activity 管理 的 Fragment 栈 中 , 这 可 以 很 
方便 地 找 回 已 被 压 入 栈 中 的 Fragment. 

ListFragment: 可 以 展示 一 个 内 置 的 AdapterView， 该 AdapterView 由 一 个 Adapter 
管理 ， 如 SimpleCursorAdapter。ListFragment 类 似 于 ListActivity， 它 提供 了 大 量 
的 用 于 管理 ListView 的 方法 ， 如 回调 方法 onListItemClick0， 其 用 于 处 理 单 击 项 
事件 。 

PreferenceFragment: 可 以 展示 层级 嵌 套 的 Preference 对 象 列表 .PreferenceFragment 
类 似 于 PreferenceActivity， 该 类 一 般 用 于 为 应 用 程序 编写 设置 页 面 。 
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Fragment 绑 定 UI 布 局 需 
代码 如 下 : 


class ItemDetailFragment : Fragment() { 


写 onCreateView() 方 法 , 该 方法 返回 一 个 View 视图 对 象 ， 


private var mItem: DummyContent.DummyItem? = null 


override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, 
savedInstanceState: Bundle?): View? { 
val rootView = inflater.inflate(R.layout.item_detail, container, false) 


//Show the dummy content as text in a TextView. 
mItem?.let { 
rootView.item_ detail. test = it.details 


} 
return rootView 


} 


其 中 ，val rootView=inflater.inflate(R.layout.item_detail,container, false) 这 一 行 代 码 中 的 
inflater.inflate 是 用 于 填充 布局 的 ,这 是 布局 填充 器 LayoutInflater 类 的 方法 。 通 常 我 们 加 载 
布局 的 任务 都 是 在 Activity 中 调用 setContentView0 方 法 来 完成 的 。 其 实 setContentView() 
方法 的 内 部 也 是 使 用 LayoutInflater 类 来 加 载 布 局 的 ， 相 关 的 代码 在 android.support. 
V7.app.AppCompatDelegateImplV9 中 。 

@Override 

public void setContentView(int resId) { 


ensureSubDecor () ; 


ViewGroup contentParent = (ViewGroup) mSubDecor . findViewById (android.R.id. 
content); 
contentParent .removeAllViews (); 
LayoutInflater.from(mContext) .inflate(resId, contentParent) ; 
mOriginalWindowCallback.onContentChanged () ; 

1 


在 实际 开发 中 ，LayoutInflater 类 还 是 非常 有 用 的 ， 它 的 作用 类 似 于 findViewById0。 
不 同 点 是 LayoutInflater 是 用 来 找 resayout\ 下 的 XML 布局 文件 并 实例 化 (填充 布局 ) ; 而 
findViewById0 是 找 XML 布局 文件 下 的 具体 widget 控件 (如 Button, TextView 等 ) 并 实 
例 化 。 

LayoutInflater 具体 作用 说 明 如 下 : 

O 对 于 一 个 没有 被 载 入 或 者 想 要 动态 载 入 的 界面 ， 都 需要 使 用 LayoutInflater.inflate0 


来 载 入 ; 
D 对 于 一 个 已 经 载 入 的 界面 ， 可 以 使 用 Activiyt findViewById() 方 法 来 获得 其 中 的 界 
面 元 素 。 


AFE: 若 继承 的 Fragment 是 ListFragment，onCreateView() 方 法 已 默认 返回 了 ListView 
对 象 ， 因 此 无 须 再 重 写 该 方法 。 


有 关 Fragment 的 更 多 信息 , 请 参见 “Fragment API 指南 ”: http://developer.android.com/ 
guide/components/fragments.html。 
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14.2.9 测试 数据 类 DummyContent 


在 DummyContent 类 中 构造 了 我 们 在 ListActivity 中 展示 的 测试 数据 。 代 码 如 下 : 
package com.easy.kotlin.dummy 


import java-.util.ArrayList 
import java.util.HashMap 


object DummyContent { 


val ITEMS: MutableList<DummyItem> = ArrayList () 
val ITEM MAP: MutableMap<String, DummyItem> = HashMap () 


private val COUNT = 25 


init { 
//Add some sample items. 
Eow (1 in 1: COUNT) f 
addItem(createDummyItem (i) ) 
} 
} 


private fun addItem(item: DummyItem) { 
ITEMS .add (item) 
ITEM MAP.put(item.id, item) 

} 


private fun createDummyItem(position: Int): DummyItem { 
return DummyItem(position.toString(), "Item " + position, makeDetails 
(position) ) 


} 


private fun makeDetails(position: Int): String { 
val builder = StringBuilder () 
builder.append("Details about Item: ") .append(position) 
for (i in 0..position = 1) { 
builder.append("\nMore details information here.") 
} 
return builder.toString() 


} 
data class DummyItem(val id: String, val content: String, val details: String) { 
override fun toString(): String = content 


} 
} 


至 此 ， 我 们 已 经 了 解 了 怎样 使 用 Android Studio 3.0 创建 一 个 带 ListActivity 和 
Fragment 列表 及 其 详情 页 的 方法 ， 同 时 学 习 了 Activity 和 Fragment 的 基本 用 法 。 

下 面 我 们 来 实现 后 端 API 的 接 入 与 数据 的 展现 。 
14.2.10 ”创建 领域 对 象 类 Movie 

创建 领域 对 象 类 Movie。 我 们 使 用 Kotlin 中 的 数据 类 来 实现 ， 代 码 如 下 : 
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data class Movie(val id: String, val title: String, val overview: String, 
val posterPath: String) { 
override fun toString(): String { 
return "Movie (id="$id', title='$title', overview='Soverview', posterPath 
='SposterPath')" 


i 


其 中 的 id, title, overview, posterPath 分 别 与 JSON 中 的 key 对 应 。 接 下 来 是 ISON 
数据 的 解析 。 


14.2.11 JSON 数据 解析 


我 们 调用 的 API 是 : 


val VOTE AVERAGE API = 
"http: //api.themoviedb.org//3/discover/movie? certification country=USé&cer- 


tification=Résort by=vote average.desc&api key=7e55a88ece9f03408b895a96 
c1487979" 


其 数据 返回 如 下 : 


{ 

PAG 

"total results": 10350, 

"total pages": 518, 

"results": [ 

{ 
"vote count": 28, 
=id”: 138878, 
"video": false, 
"vote average": 10, 
"title": "Fatal Mission", 
"popularity": 3.721883, 
"poster path": "/u351Rsqu5nd36ZpbWxIpd3CpbJW. jpg", 
"original language": "en", 
"original title": "Fatal Mission", 
"genre ids": [ 
10752, 


“backdrop path": "/wNqSuqVDT7a5G1b97f£fYf4hxzYz.jpg", 

"adult": false, 

"overview": "A CIA Agent must rely on reluctant help from a female spy 
in the North Vietnam jungle in order to pass through enemy lines.", 
"release daten: "1990-07-25" 


我 们 使 用 fastjson 来 解析 这 个 ISON 数据 。 在 app 文件 夹 下 的 build.gradle 中 添加 以 下 
依赖 : 
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dependencies { 


//https://mvnrepository.com/artifact/com.alibaba/fastjson 
compile group: 'com.alibaba', name: 'fastjson', version: '1.2.39' 


} 
解析 代码 如 下 : 


val jsonstr = URL(VOTE AVERAGE APT) .readText (Charset.defaultCharset ()) 
try { 

val obj = JSON.parse(jsonstr) as Map<*, *> 

val dataArray = obj.get("results") as JSONArray 

//TODO 


} catch (ex: Exception) { 


} 
然后 把 这 个 dataArray 放 到 我 们 的 MovieContent 对 象 中 。 


dataArray.forEachIndexed { index, it -> 

val title = (it as Map<*, *>) .get ("title") as String 

val overview = it.get("overview") as String 

val poster path = it.get("poster_ path") as String 

addMovie (Movie (index.toString(), title, overview, getPosterUr] (poster path) ) ) 
j 


其 中 ，addMovie 代码 如 下 : 


object MovieContent { 
val MOVIES: MutableList<Movie> = ArrayList () 
val MOVIE MAP: MutableMap<String, Movie> = HashMap () 
private fun addMovie(movie: Movie) { 
MOVIES.add (movie) 
MOVIE MAP.put (movie.id, movie) 
J 
} 


然后 再 分 别 新 建 MovieDetailActivity, MovieDetailFragment, MovieListActivity 及 


activity_movie_list.xml, activity_movie_detail.xml, movie detail ml, movie_list.xml, movie ` 
list_content.xml 文件 ， 下 面 分 别 对 它们 进行 介绍 。 


14.2.12 ”电影 列表 页 面 


MovieListActivity 是 电影 列表 页 面 的 Activity， 代 码 如 下 : 
package com.easy.kotlin 


import android.content.Intent 

import android.os.Bundle 

import android.support.v7.app.AppCompatActivity 
import android.support.v7.widget .RecyclerView 
import android.view.LayoutInflater 

import android.view.View 

import android.view.ViewGroup 

import android.widget . Image ien 
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import android.widget.TextView 

import com.easy.kotlin.bean.MovieContent 

import com.easy.kotlin.util.HttpUtil 

import kotlinx.android.synthetic.main.activity movie detail.* 
import kotlinx.android.synthetic.main.activity movie list.* 
import kotlinx.android.synthetic.main.movie list.* 

import kotlinx.android.synthetic.main.movie list_content.view.* 


class MovieListActivity : AppCompatActivity() { 
private var mTwoPane: Boolean = false 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate (savedInstanceState) 
setContentView(R.layout.activity movie list) 


setSupportActionBar (toolbar) 
toolbar.title = title 


if (movie detail container != null) { 
mTwoPane = true 

} 

setupRecyclerView(movie list) 


} 


private fun setupRecyclerView(recyclerView: RecyclerView) { 
recyclerView.adapter = SimpleItemRecyclerViewAdapter (this, MovieContent. 
MOVIES, mTwoPane) 

} 


class SimpleItemRecyclerViewAdapter (private val mParentActivity: MovieList- 
Activity, 
private val mValues: List<MovieContent .Movie>, 
private val mTwoPane: Boolean) 
RecyclerView.Adapter<SimpleItemRecyclerViewAdapter.ViewHolder>() { 


private val mOnClickListener: View.OnClickListener 


init { 
mOnClickListener = View.OnClickListener { v -> 
val item = v.tag as MovieContent.Movie 
if (mTwoPane) { 
val fragment = MovieDetailFragment()-.apply { 
arguments = Bundle() 
arguments .putString (MovieDetailFragment.ARG MOVIE ID, 
item.id) 
} 
mParentActivity.supportFragmentManager 
-beginTransaction() 
-replace (R.id.movie detail container, fragment) 
.commit () 
} else { 
val intent = Intent (v.context, MovieDetailActivity::class. 
java) .apply { 
putExtra (MovieDetailFragment.ARG MOVIE ID, item.id) 
} 


v.context.startActivity (intent) 
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override fun onCreateViewHolder (parent: ViewGroup, viewType: Int): 
ViewHolder { 
val view = 
LayoutInflater 
-from (parent .context) 
- inflate (R.layout.movie list content, parent, false) 
return ViewHolder (view) 


if 


override fun onBindViewHolder (holder: ViewHolder, position: Int) { 
val item = mValues [position] 
holder.mIdView.text = item.id 
holder.mTitle.text = item.title 
holder .mMoviePosterImageView.setImageBitmap (HttpUtil.getBitmap 
FromURL (item.posterPath) ) 


with (holder.itemView) { 
tag = item 
setOnClickListener (mOnClickListener) 


} 


override fun getItemCount(): Int { 
return mValues.size 


} 


inner class ViewHolder (mView: View) : RecyclerView.ViewHolder (mView) { 
val mIdView: TextView = mView.id text 
val mTitle: TextView = mView.title 
val mMoviePosterImageView: ImageView = mView.movie poster image 


} 


对 应 的 布局 文件 分 别 如 下 。 
activity_movie_list.xml 文件 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 

<android. support .design.widget .CoordinatorLayout 

xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
xmlns:tools="http://schemas.android.com/tools" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: fitsSystemWindows="true" 
tools:context="com.easy.kotlin.MovieListActivity"> 


<android. support .design.widget .AppBarLayout 
android:id="@+id/app bar" 
android:layout width="match parent" 
android:layout height="wrap content" 
android: theme="@style/AppTheme .AppBarOverlay"> 


<android.support.v7.widget.Toolbar 
android: id="@+id/toolbar" 
android:layout width="match parent" 
android: layout height="?attr/actionBarSize" 
app : popupTheme="@style/AppTheme.PopupOverlay" /> 


</android. support .design.widget .AppBarLayout> 
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<FrameLayout 
android: id="@+id/frameLayout" 
android: layout width="match parent" 
android:layout height="match parent" 


app: layout_behavior="@string/appbar_ scrolling view behavior"> 


<include layout="@layout/movie list" /> 
</FrameLayout> 


</android. support .design.widget .CoordinatorLayout> 


movie_list.xml 文件 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<android.support.v7.widget .RecyclerView 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
xmlns:tools="http://schemas.android.com/tools" 
android:id="@+id/movie list" 
android:name="com.easy.kotlin.MovieListFragment" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android: layout_marginLeft="16dp" 
android: layout_marginRight="16dp" 
app: layoutManager="LinearLayoutManager" 
tools:context="com.easy.kotlin.MovieListActivity" 
tools: listitem="@layout/movie list content /> 


movie_list_content.xml 文件 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 


android:layout width="match parent" 

android: layout height="320dp" 

android:layout gravit center" 

android:layout margin="0dp" 
android:clickable="true" 

android: foreground="?attr/selectableItemBackground" 
android: orientation="horizontal"> 


<TextView 
android:id="@tid/id text" 
android: layout width="wrap content" 
android: layout height="wrap content" 
android: layout_margin="@dimen/text_margin" 
android: textAppearance="?attr/textAppearanceListItem" /> 


<ImageView 
android: id="@+id/movie_poster_image" 
android: layout_width="match_parent" 
android: layout_height="match_parent" 
android:scaleType="centerCrop" /> 


<View 
android: id="@+tid/title background" 
android: layout width="match parent" 
android:layout height="48dp" 
android:layout gravity="bottom" 
android:alpha="0.8" 
android: background="@color/colorPrimaryDark" 
android:gravity="center" /> 
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<TextView 
android: id="@+id/title" 
android: layout width="match parent" 
android:layout height="48dp" 
android:layout gravity="bottom" 
android: gravity="center" 
android: paddingLeft="@dimen/activity horizontal margin" 
android: paddingRight="@dimen/activity horizontal margin" 
android: textColor="@android:color/white" 
android:textSize="12sp" /> 


</FrameLayout> 


电影 列表 整体 布局 的 UI 效果 图 如 图 14-36 所 示 。 


PA s:00 


Item 0 


Item 1 


图 14-36 电影 列表 的 整体 布局 


14.213 ”视图 数据 适配器 ViewAdapter 


在 创建 MovieListActivity 过 程 中 需要 展示 响应 的 数据 ， 这 些 数据 由 ViewAdapter 来 承 
载 ， 对 应 的 代码 如 下 : 
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override fun onCreate (savedInstanceState: Bundle?) { 
super .onCreate (savedInstanceState) 
setContentView(R.layout.activity movie list) 


setSupportActionBar (toolbar) 
toolbar.title = title 


if (movie detail container != null) { 
mTwoPane = true 


} 


setupRecyclerView (movie list) 


} 


private fun setupRecyclerView(recyclerView: RecyclerView) { 
recyclerView.adapter = SimpleItemRecyclerViewAdapter (this, MovieContent. 
MOVIES, mTwoPane) 

J 


在 上 面 的 代码 中 定义 了 一 个 继承 RecyclerView.Adapter 的 SimpleltemRecycler 
ViewAdapter 类 ， 来 装载 View 中 要 显示 的 数据 ， 实 现 数 据 与 视图 的 解 而 。View 要 显示 的 
数据 从 Adapter 里 获取 并 展现 出 来 。Adapter 负责 把 真实 的 数据 适 配 成 一 个 个 View， 也 就 
是 说 View 要 显示 什么 数据 ， 取 决 于 Adapter 里 的 数据 。 


14.2.14 ”视图 中 图 像 的 展示 


在 函数 SimpleItemRecyclerViewAdapteronBindViewHolder0 中 ， 设 置 View 组 件 与 
Model 数据 的 绑 定 。 其 中 的 电影 海报 是 图 片 ， 所 以 我 们 的 布局 文件 中 使 用 了 ImageView， 
对 应 的 布局 文件 是 movie_list_content.xml， 代 码 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android: layout_width="match_parent" 
android: layout_height="320dp" 
android: layout_gravity="center" 
android: layout_margin="0dp" 
android:clickable="true" 
android: foreground="?attr/selectableItemBackground" 
android: orientation="horizontal"> 


<TextView 
android:id="@tid/id text" 
android:layout width="wrap content" 
android:layout height="wrap content" 
android:layout margin="@dimen/text margin" 
android: textAppearance="?attr/textAppearanceListItem" /> 


<ImageView 
android: id="@+id/movie poster image" 
android:layout width="match parent" 
android: layout height="match parent" 
android:scaleType="centerCrop" /> 


<View 
android: id="@tid/title background" 
android: layout_width="match_ parent" 
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android:layout height="48dp" 

android:layout gravity="bottom" 
android:alpha="0.8" 

android: background="@color/colorPrimaryDark" 
android:gravity="center" /> 


<TextView 
android:id="@+tid/title" 
android: layout_width="match parent" 
android: layout height="48dp" 
android:layout gravity="bottom" 
android: gravity="center" 
android: paddingLeft="@dimen/activity horizontal margin" 
android:paddingRight="@dimen/activity horizontal margin" 
android: textColor="@android:color/white" 
android:textSize="12sp" /> 


</FrameLayout> 


UI 设计 效果 图 如 图 14-37 所 示 。 


ImageView 


图 14-37 movie list content.xml 布局 UI 效果 图 
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列表 中 图 片 的 视图 组 件 标签 是 ImageView， 布 局 的 XML 代码 如 下 : 


<ImageView 

android:id="@+id/movie poster image" 
layout width="match parent" 
layout height="match parent" 
android:scaleType="centerCrop" /> 


这 里 是 根据 图 片 的 URL 来 展示 图 片 ，ImageView 类 有 个 setImageBitmap 方法 ， 可 以 
直接 设置 Bitmap 图 片 数 据 。 见 下 面 的 代码 : 


holder .mMoviePosterImageView.setImageBitmap (HttpUtil.getBitmapFromURL 
(item.posterPath)) 


而 通过 URL 获取 Bitmap 图 片 数据 的 代码 是 : 


object HttpUtil { 
fun getBitmapFromURL(src: String): Bitmap? { 

try { 
val url = URL(src) 
val input = url.openStream() 
val myBitmap = BitmapFactory.decodeStream (input) 
return myBitmap 

} catch (e: Exception) { 
e.printStackTrace() 
return null 


14.215 ”电影 详情 页 面 


MovieDetailActivity 文件 (电影 详情 页 面 ) 代 码 如 下 : 
package com.easy.kotlin 


import android.content.Intent 

import android.os.Bundle 

import android.support.design.widget .Snackbar 

import android. support.v7.app.AppCompatActivity 

import android.view.MenuItem 

import kotlinx.android.synthetic.main.activity_ movie detail.* 


class MovieDetailActivity : AppCompatActivity() { 


override fun onCreate(savedInstanceState: Bundle?) { 
super .onCreate (savedInstanceState) 
setContentView(R.layout.activity movie detail) 
setSupportActionBar (detail toolbar) 


fab.setOnClickListener { view -> 
Snackbar.make (view, "Replace with your own detail action", Snackbar. 
LENGTH LONG) 
-setAction("Action", null) .show() 
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supportActionBar?.setDisplayHomeAsUpEnabled (true) 
if (savedInstanceState == null) { 
val arguments = Bundle() 
arguments.putString (MovieDetailFragment.ARG MOVIE ID, 
intent .getStringExtra (MovieDetailFragment .ARG MOVIE ID)) 
val fragment = MovieDetailFragment () 
fragment.arguments = arguments 
supportFragmentManager.beginTransaction() 
-add(R.id.movie detail container, fragment) 
-commit () 


} 


override fun onOptionsItemSelected(item: MenuItem) = 
when (item.itemId) { 
android.R.id-home -> { 
navigateUpTo (Intent (this, MovieListActivity::class.java) ) 
true 
} 


else -> super.onOptionsItemSelected (item) 
} 
其 中 ， 详 情 页 的 布局 XML 文件 是 activity_item_detail.xml， 其 代码 如 下 : 


<android.support.design.widget.CoordinatorLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:app="http://schemas.android.com/apk/res-auto" 
xmlns:tools="http://schemas.android.com/tools" 
android: layout_width="match_parent" 
android:layout height="match parent" 
android: fitsSystemWindows="true" 
tools:context="com.easy.kotlin.ItemDetailActivity" 
tools: ignore="MergeRootFrame"> 


<android. support .design.widget .AppBarLayout 
android: id="@+id/app bar" 
android: layout width="match parent" 
android:layout height="@dimen/app bar height" 
android: fitsSystemWindows="true" 
android: theme="@style/ThemeOverlay.AppCompat .Dark.ActionBar"> 


<android.support .design.widget .CollapsingToolbarLayout 
android:id="@tid/toolbar layout" 
android: layout_width="match_parent" 
android:layout height="match parent" 
android: fitsSystemWindows="true" 
app: contentScrim="?attr/colorPrimary" 
app: layout_scrol1Flags="scroll1|exitUntilCollapsed" 
app: toolbarId="@+tid/toolbar"> 


<android.support.v7.widget.Toolbar 
android: id="@+id/detail toolbar" 
android:layout width="match parent" 
android:layout height="?attr/actionBarSize" 
app:layout collapseMode="pin" 
app: popupTheme="@style/ThemeOverlay.AppCompat.Light" /> 
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</android.support.design.widget.CollapsingToolbarLayout> 


</android.support.design.widget.AppBarLayout> 


<android.support.v4.widget.NestedScrollView 


android:id="@+id/item detail container" 

android:layout width="match parent" 

android:layout height="match parent" 

app: layout_behavior="@string/appbar_scrolling view behavior" 


<android.support.design.widget .FloatingActionButton 


android: id="@tid/fab" 

android: layout_width="wrap_ content" 

android:layout height="wrap content" 

android:layout gravity="center vertical|start" 
android: layout margin="@dimen/fab margin" 

app: layout_anchor="@+id/item_ detail container" 
app:layout anchorGravity="top|end" 

app: srcCompat="@android:drawable/stat notify chat" /> 


</android. support .design.widget .CoordinatorLayout> 


我 们 把 电影 详情 的 Fragment 的 展示 放 到 NestedScrollView 中 : 


<android.support.v4.widget .NestedScrollView 
android:id="@tid/movie detail container" 
android:layout width="match parent" 
android: layout_height="match_parent" 
android: fitsSystemWindows="true" 
app: layout_behavior="@string/appbar scrolling view behavior" /> 


电影 详情 的 Fragment 代码 是 MovieDetailFragment: 


package com.easy.kotlin 


import 
import 
import 
import 
import 
import 
import 
import 
import 


android.os.Bundle 

android. support.v4.app.Fragment 
android.view.LayoutInflater 

android.view.View 

android. view.ViewGroup 
com.easy.kotlin.bean.MovieContent 
com.easy.kotlin.util.HttpUtil 
kotlinx.android.synthetic.main.activity movie detail.* 
kotlinx.android.synthetic.main.movie_detail.view.* 


class MovieDetailFragment : Fragment() { 
private var mItem: MovieContent.Movie? = null 


override fun onCreate(savedinstanceState: Bundle?) { 


super .onCreate (savedInstanceState) 
if (arguments.containsKey (ARG MOVIE ID)) { 


/> 


mItem = MovieContent .MOVIE MAP [arguments .getString (ARG MOVIE ID) ] 


mItem?.let { 
activity.toolbar layout?.title = it.title 


#259." 


Kotlin 从 入 门 到 进 阶 实 战 


override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, 
savediInstanceState: Bundle?): View? { 


// 绑 定 movieDetailView 


val movieDetailView = inflater.inflate(R.layout.movie detail, container, 


false) 
mItem?.let { 


movieDetailView.movie poster _image.setImageBitmap (HttpUtil. 


getBitmapFromURL (it .posterPath) ) 


movieDetailView.movie overview.text= "影片 简介 : ${it.overview}" 
movieDetailView.movie vote count.text = "打分 次 数 : ${it.vote_count}" 


movieDetailView.movie vote average .text 


评分 : ${it.vote_average}" 


movieDetailView.movie release date.text = "发行 日 期 :${it.release date}" 


} 


return movieDetailView 


} 


companion object { 
const val ARG MOVIE ID = "movie id" 
} 
} 


其 中 的 R.layout.movie_detail 布局 文件 movie _detail.xml 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 


xmlns:tools=http://schemas.android.com/tools 
android: layout_width="match_parent" 

android:layout height="match parent" 

android:layout gravity="center" 

android:layout margin="0dp" 
android:clickable="true" 

android: foreground="?attr/selectableItemBackground" 
android: orientation="vertical"> 


<TextView 
android:id="@tid/movie release date" 
android: layout width="match parent" 
android: layout_height="match_parent" 
android: padding="16dp" 
android: textIsSelectable="true" 
android: textSize="18sp" 
tools:context="com.easy.kotlin.MovieDetailFragment" 


<ImageView 
android: id="@+id/movie poster image" 
android: layout_width="match_ parent" 
android:layout height="match parent" 
android: layout centerVertical="true" 
android: fitsSystemWindows="true" 
android:scaleType="fitCenter" /> 


<TextView 
android: id="@+id/movie_ overview" 
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android:layout width="match parent" 

android: layout_height="match_parent" 

android: padding="16dp" 

android: textIsSelectable="true" 
android:textSize="18sp" 

tools: context="com.easy.kotlin.MovieDetailFragment" /> 


<TextView 
android:id="@+id/movie vote average" 
android: layout_width="match_parent" 
android: layout height="match parent" 
android: padding="16dp" 
android: textIsSelectable="true" 
android: textSize="18sp" 
tools:context="com.easy.kotlin.MovieDetailFragment" /> 


<TextView 
android:id="@+id/movie vote count" 
android: layout width="match parent" 
android: layout height="match parent" 
android: padding="16dp" 
android: textIsSelectable="true" 
android: textSize="18sp" 
tools:context="com.easy.kotlin.MovieDetailFragment" /> 


</LinearLayout> 


14.2.16 ”电影 源 数据 的 获取 


首先 定义 一 个 MovieContent 对 象 类 来 存储 从 API 获取 的 数据 ， 代 码 如 下 : 


package com.easy.kotlin.bean 


import android.os.StrictMode 

import com.alibaba.fastjson.JSON 
import com.alibaba.fastjson.JSONArray 
import java.net.URL 

import java.nio.charset.Charset 
import java.util.* 


object MovieContent { 


val MOVIES: MutableList<Movie> = ArrayList () 
val MOVIE MAP: MutableMap<String, Movie> = HashMap () 


val VOTE AVERAGE API = "http://api.themoviedb.org//3/discover/movie? 
sort by=popularity.desc&api key=7e55a88ece9f03408b8 95a96c148797 9&page=1" 


Imt A 
val policy = StrictMode.ThreadPolicy.Builder() .permitAl1() .build() 


StrictMode.setThreadPolicy (policy) 
initMovieListData() 


SZ 
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Private fun initMovieListData() { 


val jsonstr = URL (VOTE AVERAGE APT) . readText (Charset .defaultCharset () ) 
try { 

val obj = JSON.parse(jsonstr) as Map<*, *> 

val dataArray = obj.get("results") as JSONArray 


dataArray.forEachIndexed { index, it -> 
val title = (it as Map<*, *>).get("title") as String 
val overview = it.get("overview") as String 
val poster_path = it.get("poster path") as String 
val vote_count = it.get("vote_count") .toString() 
val vote_average = it.get("vote_average") .toString() 
val release date = it.get("release date") .toString() 
addMovie (Movie (id = index.toString(), 
title = title, 
overview = overview, 
vote_count = vote count, 
vote average = vote average, 
release date = release date, 
posterPath = getPosterUrl (poster path) )) 
} 


} catch (ex: Exception) { 
ex.printStackTrace () 
} 
} 


private fun addMovie(movie: Movie) { 
MOVIES.add (movie) 
MOVIE MAP.put (movie.id, movie) 

} 


fun getPosterUrl(posterPath: String): String { 
return "https://image.tmdb.org/t/p/w185_and_h278_bestv2$posterPath" 


} 


data class Movie(val id: String, 
val title: String, 
val overview: String, 
val vote _count: String, 
val vote average: String, 
val release date: String, 
val posterPath: String) 


} 
在 Android 4.0 之 后 默认 的 线程 模式 是 不 允许 在 主线 程 中 访问 网 络 的。 为 了 演示 效果 ， 
我 们 在 访问 网 络 代码 前 ， 把 ThreadPolicy 设置 为 允许 运行 访问 网 络 。 


val policy = StrictMode.ThreadPolicy.Builder() .permitAll() .build() 
StrictMode.setThreadPolicy (policy) 


然后 使 用 一 个 data class Movie 来 存储 电影 对 象 数据 。 


data class Movie (val id: String, 
val title: String, 
val overview: String, 
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val vote count: String, 
val vote average: String, 
val release date: String, 
val posterPath: String) 


14.2.17 配置 AndroidManifest.xml 


最 后 配置 AndroidManifest.xml 文件 内 容 如 下 : 


<?xml version="1.0" encoding="utf-8"?> 
<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.easy.kotlin"> 


<application 
android: allowBackup="true" 
android:icon="@mipmap/ic launcher" 
android: label="@string/app name" 
android: roundIcon="@mipmap/ic launcher round" 
android: supportsRtl="true" 
android: theme="@style/AppTheme"> 
<activity 
android:name=".MovieListActivity" 
android: label="@string/app_ name" 
android: theme="@style/AppTheme .NoActionBar"> 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity 
android:name=".MovieDetailActivity" 
android: label="@string/title movie detail" 
android: parentActivityName=".MovieListActivity” 
android: theme="@style/AppTheme .NoActionBar"> 
<meta-data 
android:name="android.support.PARENT ACTIVITY" 
android:value="com.easy.kotlin.MovieListActivity" /> 
</activity> 
</application> 


<uses-permission android:name="android.permission. INTERNET" /> 
</manifest> 
因为 我 们 要 访问 网 络 ， 所 以 需要 添加 以 下 配置 


<uses-permission android:name="android.permission.INTERNET" /> 


14.2.18 打包 安装 测试 


再 次 打包 安装 并 运行 程序 ， 电 影 列 表 页 面 如 图 14-38 所 示 。 
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点 击 进入 电影 详情 页 ， 如 图 14-39 所 示 。 
od %4 0 12:59 
电影 指南 
、 Ze 


影片 简介 : Following the events of 
Captain America: Civil War, Peter Parker, 
with the help of his mentor Tony Stark, 
tries to balance his life as an ordinary 
high school student in Queens, New York 
City, with fighting crime as his superhero 
alter ego Spider-Man as a new threat, the 
Vulture, emerges. 


评分 ; 7.3 
打分 次 数 : 4181 


发 行 日 期 : 2017-07-05 


图 14-38 ”电影 列表 页 面 图 14-39 电影 详情 页 


14.3 本 章 小 结 


Android 中 经 常 出 现 的 空 引 用 、API 的 元 余 样 板式 代码 等 都 是 驱动 我 们 转向 Kotlin 语言 
的 动力 。 另 外 ，Kotlin 的 Android 视图 DSL Anko 可 以 让 我 们 从 繁杂 的 XML 视图 配置 文件 
中 解放 出 来 。 

我 们 可 以 像 在 Java 中 一 样 方便 地 使 用 Android 开发 流行 的 库 , 如 Butter Knife, Realm, 
RecyclerView 等 。 当 然 ， 使 用 Kotlin 集成 这 些 库 进 行 Android 开发 ， 既 能 够 直接 使 用 我 们 
之 前 的 开发 库 ， 又 能 够 从 Java 语言 、Android API 的 限制 中 解脱 出 来 ， 这 不 得 不 说 是 一 件 
We. RK, Android 领域 将 是 Kotlin 的 天 下 。 

本 章 工 程 源码 地 址 是 https://github.com/Android-KotlinMovieGuideDB。 
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